chrome.printing
Description
使用 chrome.printing
API 将打印作业发送到 Chromebook 上安装的打印机。
Permissions
printing
Availability
Chrome 81+
Summary
Types
Properties
Methods
Events
Types
GetPrinterInfoResponse
PROPERTIES
capabilities
object optional
CDD format的打印机功能。该属性可能丢失。
status
打印机的状态。
JobStatus
打印作业的状态。
TYPE
"PENDING", "IN_PROGRESS", "FAILED", "CANCELED", or "PRINTED"
Printer
PROPERTIES
description
string
打印机的人类可读描述。
id
string
打印机标识符;保证在设备上的打印机中是唯一的。
isDefault
boolean
显示打印机是否符合 DefaultPrinterSelection 规则的标志。请注意,可能会标记多台打印机。
name
string
打印机的名称。
recentlyUsedRank
number optional
显示打印机用于从 Chrome 打印的最近时间的值。值越低,打印机使用得越近。最小值为 0。缺失值表示最近未使用打印机。该值保证在打印机中是唯一的。
source
打印机的来源(配置的用户或策略)。
uri
string
打印机 URI。扩展程序可以使用它来为用户选择打印机。
PrinterSource
打印机的来源。
TYPE
"USER", or "POLICY"
PrinterStatus
打印机的状态。
TYPE
"DOOR_OPEN", "TRAY_MISSING", "OUT_OF_INK", "OUT_OF_PAPER", "OUTPUT_FULL", "PAPER_JAM", "GENERIC_ISSUE", "STOPPED", "UNREACHABLE", or "AVAILABLE"
SubmitJobRequest
PROPERTIES
job
要提交的打印作业。唯一支持的内容类型是
“application/pdf”
,CJT 票证不应包含FitToPageTicketItem
、PageRangeTicketItem
、ReverseOrderTicketItem
和VendorTicketItem
字段,因为它们与本机打印无关。所有其他字段都必须存在。
SubmitJobResponse
PROPERTIES
jobId
string optional
创建的打印作业的 id。这是设备上所有打印作业中的唯一标识符。如果状态不正常,jobId 将为空。
status
请求的状态。
SubmitJobStatus
submitJob
请求的状态。
TYPE
"OK", or "USER_REJECTED"
Properties
MAX_GET_PRINTER_INFO_CALLS_PER_MINUTE
每分钟可以调用 getPrinterInfo
的最大次数。
VALUE
20
MAX_SUBMIT_JOB_CALLS_PER_MINUTE
每分钟可以调用 submitJob
的最大次数。
VALUE
40
Methods
cancelJob
chrome.printing.cancelJob(
jobId: string,
callback: function,
)
取消之前提交的作业。
PARAMETERS
jobId
string
要取消的打印作业的 ID。这应该与
SubmitJobResponse
中收到的 ID 相同。callback
function
The
callback
parameter looks like:() => void
getPrinterInfo
chrome.printing.getPrinterInfo(
printerId: string,
callback: function,
)
以 CDD format返回打印机的状态和功能。如果没有安装具有给定 id 的打印机,则此调用将失败并显示运行时错误。
PARAMETERS
printerId
string
callback
function
The
callback
parameter looks like:(response: GetPrinterInfoResponse) => void
response
getPrinters
chrome.printing.getPrinters(
callback: function,
)
返回设备上可用打印机的列表。这包括手动添加的、企业的和发现的打印机。
PARAMETERS
submitJob
chrome.printing.submitJob( request: SubmitJobRequest, callback: function, )
提交作业进行打印。如果扩展未在 PrintingAPIExtensionsAllowlist 策略中列出,系统将提示用户接受打印作业。
PARAMETERS
request
callback
function
The
callback
parameter looks like:(response: SubmitJobResponse) => void
response
Events
onJobStatusChanged
chrome.printing.onJobStatusChanged.addListener(
callback: function,
)
作业状态更改时触发的事件。这仅针对此扩展程序创建的作业触发。
PARAMETERS
callback
function
The
callback
parameter looks like:(jobId: string, status: JobStatus) => void
jobId
string
status
By.一粒技术服务.