chrome.printing

설명

권한

지원 대상

모든 chrome.printing 메서드와 이벤트를 사용하려면 확장 프로그램 매니페스트에서 "printing" 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "printing"
  ],
  ...
}

예

아래 예는 인쇄 네임스페이스의 각 메서드를 사용하는 방법을 보여줍니다. 이 코드는 extensions-samples GitHub 저장소의 api-samples/printing에서 또는 이를 기반으로 복사됩니다.

cancelJob()

이 예시에서는 onJobStatusChanged 핸들러를 사용하여 jobStatus가 PENDING 또는 IN_PROGRESS가 아닌 경우 '취소' 버튼을 숨깁니다. 일부 네트워크나 크롬북이 프린터에 직접 연결된 경우 이러한 상태가 너무 빨리 지쳐 취소 버튼이 호출되기에 충분히 오래 표시되지 못할 수 있습니다. 이는 인쇄 예를 크게 단순화한 것입니다.

chrome.printing.onJobStatusChanged.addListener((jobId, status) => {
  const cancelButton = document.getElementById("cancelButton");
  cancelButton.addEventListener('click', () => {
    chrome.printing.cancelJob(jobId).then((response) => {
      if (response !== undefined) {
        console.log(response.status);
      }
      if (chrome.runtime.lastError !== undefined) {
        console.log(chrome.runtime.lastError.message);
      }
    });
  });
  if (status !== "PENDING" && status !== "IN_PROGRESS") {
    cancelButton.style.visibility = 'hidden';
  } else {
    cancelButton.style.visibility = 'visible';
  }
}

getPrinters() and getPrinterInfo()

프린터 정보를 가져오려면 getPrinters()를 호출하여 가져오는 프린터 ID가 필요하므로 이러한 함수에 한 가지 예가 사용됩니다. 이 예에서는 기본 프린터의 이름과 설명을 콘솔에 기록합니다. 다음은 인쇄 예제의 단순화된 버전입니다.

​​const printers = await chrome.printing.getPrinters();
const defaultPrinter = printers.find((printer) => {
  const printerInfo = await chrome.printing.getPrinterInfo(printer.id);
  return printerInfo.isDefault;
}
console.log(`Default printer: ${defaultPrinter.name}.\n\t${defaultPrinter.description}`);

제출 작업()

submitJob() 메서드에는 세 가지가 필요합니다.

• 사용할 프린터의 기능을 지정하는 ticket 구조 사용자가 사용 가능한 기능 중에서 선택해야 한다면 getPrinterInfo()를 사용하여 특정 프린터에서 기능을 가져오면 됩니다.
• 사용할 프린터와 인쇄할 파일 또는 날짜를 지정하는 SubmitJobRequest 구조 이 구조에는 ticket 구조에 대한 참조가 포함됩니다.
• 인쇄할 파일 또는 데이터의 blob입니다.

submitJob()를 호출하면 사용자에게 인쇄를 확인하라는 대화상자가 트리거됩니다. PrintingAPIExtensionsAllowlist를 사용하여 확인을 건너뜁니다.

다음은 인쇄 예제의 단순화된 버전입니다. ticket는 SubmitJobRequest 구조 (8행)에 연결되며 출력할 데이터가 blob으로 변환됩니다 (10행). 샘플에서는 여기에 표시된 것보다 프린터 ID (1행)를 가져오는 작업이 더 복잡합니다.

const defaultPrinter = getDefaultPrinter();
const ticket = getPrinterTicket(defaultPrinter);
const arrayBuffer = getPrintData();
const submitJobRequest = {
  job: {
    printerId: defaultPrinter,
    title: 'test job',
    ticket: ticket,
    contentType: 'application/pdf',
    document: new Blob([new Uint8Array(arrayBuffer)], {
      type: 'application/pdf'
    });
  }
};

chrome.printing.submitJob(submitJobRequest, (response) => {
  if (response !== undefined) {
    console.log(response.status);
  }
  if (chrome.runtime.lastError !== undefined) {
    console.log(chrome.runtime.lastError.message);
  }
});

롤 인쇄

이 예에서는 영수증 인쇄에 자주 사용되는 연속 (또는 롤) 인쇄를 위한 프린터 티켓을 만드는 방법을 보여줍니다. 롤 인쇄를 위한 submitJobRequest 객체는 submitJob() 예에 표시된 것과 동일합니다.

용지 자르기의 기본값을 변경해야 하는 경우 vendor_ticket_item 키를 사용합니다. (기본값은 프린터에 따라 다릅니다.) 포함되는 경우 이 키는 구성원이 하나인 배열, 즉 id가 'finishings'인 객체여야 합니다. 값은 인쇄가 끝날 때 롤을 자른 경우 'trim', 인쇄 작업을 제거해야 하는 프린터의 경우 'none'일 수 있습니다.

const ticket = {
  version: '1.0',
  print: {
    vendor_ticket_item: [{id: 'finishings', value: 'trim'}],
    color: {type: 'STANDARD_MONOCHROME'},
    duplex: {type: 'NO_DUPLEX'},
    page_orientation: {type: 'PORTRAIT'},
    copies: {copies: 1},
    dpi: {horizontal_dpi: 300, vertical_dpi: 300},
    media_size: {
      width_microns: 72320,
      height_microns: 100000
    },
    collate: {collate: false}
  }
};

일부 프린터는 "finishings" 옵션을 지원하지 않습니다. 프린터가 지원되는지 확인하려면 getPrinterInfo()를 호출하여 "finishings/11"의 "display_name"를 찾습니다.

"vendor_capability": [
  {
    "display_name": "finishings/11",
    "id": "finishings/11",
    "type": "TYPED_VALUE",
    "typed_value_cap": {
      "value_type": "BOOLEAN"
    }
  },
  ...
]

티켓의 media_size 키에 있는 값은 각 프린터마다 다릅니다. 적절한 크기를 선택하려면 getPrinterInfo()를 호출합니다. 반환된 GetPrinterResponse에는 "media_size"."option"에서 지원되는 미디어 크기의 배열이 포함됩니다. "is_continuous_feed" 값이 true인 옵션을 선택합니다. 티켓에 대해 높이 및 너비 값을 사용합니다.

"media_size": {
  "option": [
  {
    "custom_display_name": "",
    "is_continuous_feed": true,
    "max_height_microns": 2000000,
    "min_height_microns": 25400,
    "width_microns": 50800
  },
  ...
  ]
}

chrome.printing.cancelJob(
  jobId: string,
  callback?: function,
)

chrome.printing.getPrinterInfo(
  printerId: string,
  callback?: function,
)

chrome.printing.getPrinters(
  callback?: function,
)

chrome.printing.submitJob(
  request: SubmitJobRequest,
  callback?: function,
)

chrome.printing.onJobStatusChanged.addListener(
  callback: function,
)