хром.печать

Описание

Разрешения

Доступность

Для всех методов и событий chrome.printing требуется объявить разрешение "printing" в манифесте расширения . Например:

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

Примеры

Примеры ниже демонстрируют использование каждого из методов пространства имён print. Этот код скопирован из файла api-samples/printing в репозитории extensions-samples на Github или основан на нём.

cancelJob()

В этом примере обработчик onJobStatusChanged используется для скрытия кнопки «Отмена», когда jobStatus не имеет значения PENDING или IN_PROGRESS . Обратите внимание, что в некоторых сетях или при прямом подключении Chromebook к принтеру эти состояния могут сменяться слишком быстро, и кнопка отмены не успевает быть видимой и вызваться. Это значительно упрощённый пример печати.

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() и getPrinterInfo()

Для этих функций используется один пример, поскольку для получения информации о принтере требуется идентификатор принтера, который извлекается с помощью вызова getPrinters() . Этот пример выводит на консоль имя и описание принтера по умолчанию. Это упрощённая версия примера печати.

​​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()

Метод submitJob() требует трех вещей.

• Структура ticket определяющая, какие возможности принтера будут использоваться. Если пользователю необходимо выбрать доступные возможности, их можно получить для конкретного принтера с помощью getPrinterInfo() .
• Структура SubmitJobRequest , которая определяет используемый принтер, а также файл или дату для печати. Эта структура содержит ссылку на структуру ticket .
• Часть файла или данных для печати.

Вызов submitJob() открывает диалоговое окно с запросом на подтверждение печати. Для обхода подтверждения используйте PrintingAPIExtensionsAllowlist .

Это упрощённая версия примера печати. Обратите внимание, что ticket прикреплён к структуре SubmitJobRequest (строка 8), а данные для печати преобразуются в двоичный объект (строка 10). Получение идентификатора принтера (строка 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() и найдите в качестве "display_name" значение "finishings/11" .

"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,
): Promise<void>

chrome.printing.getJobStatus(
  jobId: string,
): Promise<JobStatus>

chrome.printing.getPrinterInfo(
  printerId: string,
): Promise<GetPrinterInfoResponse>

chrome.printing.getPrinters(): Promise<Printer[]>

chrome.printing.submitJob(
  request: SubmitJobRequest,
): Promise<SubmitJobResponse>

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