chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Açıklama

chrome.printerProvider API'si, yazdırma yöneticisinin uzantılar tarafından kontrol edilen yazıcıları sorgulamak, özelliklerini sorgulamak ve bu yazıcılara yazdırma işleri göndermek için kullandığı etkinlikleri gösterir.

İzinler

printerProvider

Kullanılabilirlik

Chrome 44+

Türler

PrinterInfo

Özellikler

  • açıklama

    string isteğe bağlı

    Yazıcının okunabilir açıklaması.

  • id

    dize

    Benzersiz yazıcı kimliği.

  • ad

    dize

    Yazıcının kullanıcı tarafından okunabilen adı.

PrintError

onPrintRequested etkinliğine yanıt olarak döndürülen hata kodları.

Enum

"OK"
İşlemin başarıyla tamamlandığını belirtir.

"FAILED"
Genel bir hatanın oluştuğunu belirtir.

"INVALID_TICKET"
Yazdırma biletinin geçersiz olduğunu belirtir. Örneğin, bilet bazı özelliklerle tutarsızdır veya uzantı, biletteki tüm ayarları işleyemez.

"INVALID_DATA"
Belgenin geçersiz olduğunu belirtir. Örneğin, veriler bozulmuş olabilir veya biçim, uzantıyla uyumlu olmayabilir.

PrintJob

Özellikler

  • contentType

    dize

    Doküman içeriğinin türü. Desteklenen biçimler: "application/pdf" ve "image/pwg-raster".

  • doküman

    Blob

    Yazdırılacak doküman verilerini içeren blob. Biçim contentType ile eşleşmelidir.

  • printerId

    dize

    İşi işlemesi gereken yazıcının kimliği.

  • kayıt

    nesne

    CJT biçiminde yazdırma bileti.

    CJT referansı, desteği sonlandırılmış olarak işaretlenir. Yalnızca Google Cloud Print için desteği sonlandırılmıştır. ChromeOS yazdırma için desteği sonlandırılmamıştır.

  • title

    dize

    Yazdırma işi başlığı.

Etkinlikler

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

Yazdırma yöneticisi yazıcı özelliklerini istediğinde tetiklenen etkinlik.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (printerId: string, resultCallback: function) => void

    • printerId

      dize

    • resultCallback

      işlev

      resultCallback parametresi şu şekilde görünür: 

      (capabilities: object) => void

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

Yazdırma yöneticisi, uzantılar tarafından sağlanan yazıcıları istediğinde tetiklenen etkinlik.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (resultCallback: function) => void

    • resultCallback

      işlev

      resultCallback parametresi şu şekilde görünür: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45+ 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Yazdırma yöneticisi, yazıcı olabilecek bir USB cihazı hakkında bilgi istediğinde tetiklenen etkinlik.

Not: Bir uygulama, bu etkinliğin cihaz başına birden fazla kez tetiklenmesine bağlı olmamalıdır. Bağlı bir cihaz destekleniyorsa onGetPrintersRequested etkinliğinde döndürülmelidir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (device: usb.Device, resultCallback: function) => void

    • cihaz

      usb.Device

    • resultCallback

      işlev

      resultCallback parametresi şu şekilde görünür: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

Yazdırma yöneticisi yazdırma isteğinde bulunduğunda tetiklenen etkinlik.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      işlev

      resultCallback parametresi şu şekilde görünür: 

      (result: PrintError) => void