chrome.documentScan

refresh date: 2026-09-25 robots: noindex

Açıklama

Bağlı belge tarayıcılardan görüntüleri keşfetmek ve almak için chrome.documentScan API'yi kullanın.

İzinler

documentScan

Kullanılabilirlik

Chrome 44+ Yalnızca ChromeOS

Document Scan API

Document Scan API, uygulamaların ve uzantıların, ekli bir belge tarayıcıdaki kağıt belgelerin içeriğini görüntülemesine olanak tanımak için tasarlanmıştır.

Türler

CancelScanResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • iş

    dize

    cancelScan() işlevine iletilen iş tanıtıcısının aynısını sağlar.

  • Arka ucun taramayı iptal etme sonucu. Sonuç OperationResult.SUCCESS veya OperationResult.CANCELLED ise tarama iptal edilmiştir ve tarayıcı yeni bir tarama başlatmaya hazırdır. Sonuç OperationResult.DEVICE_BUSY ise tarayıcı, istenen iptal işlemini hâlâ işliyordur. Arayan kişi kısa bir süre bekleyip isteği tekrar denemelidir. Diğer sonuç değerleri, yeniden denenmemesi gereken kalıcı bir hatayı gösterir.

CloseScannerResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • Tarayıcıyı kapatma işleminin sonucu. Bu değer SUCCESS olmasa bile herkese açık kullanıcı adı geçersiz olur ve başka işlemler için kullanılmamalıdır.

  • scannerHandle

    dize

    closeScanner işlevine iletilen tarayıcı tanıtıcısı.

Configurability

Chrome 125 ve sonraki sürümler

Bir seçeneğin nasıl değiştirilebileceği.

Enum

"NOT_CONFIGURABLE"
Seçenek salt okunurdur.

"SOFTWARE_CONFIGURABLE"
Seçenek, yazılımda ayarlanabilir.

"HARDWARE_CONFIGURABLE"
Seçenek, kullanıcı tarafından tarayıcıdaki bir düğme açılıp kapatılarak veya basılarak ayarlanabilir.

ConnectionType

Chrome 125 ve sonraki sürümler

Tarayıcının bilgisayara nasıl bağlandığını gösterir.

Enum

"UNSPECIFIED"

"USB"

"NETWORK"

ConstraintType

Chrome 125 ve sonraki sürümler

OptionConstraint ile temsil edilen kısıtlamanın veri türü.

Enum

"INT_RANGE"
OptionType.INT değer aralığıyla ilgili kısıtlama. OptionConstraint öğesinin min, max ve quant özellikleri long olacak ve list özelliği ayarlanmayacak.

"FIXED_RANGE"
OptionType.FIXED değerleri aralığındaki kısıtlama. OptionConstraint öğesinin min, max ve quant özellikleri double olarak ayarlanacak ve list özelliği kaldırılacak.

"INT_LIST"
Belirli bir OptionType.INT değerleri listesindeki kısıtlama. OptionConstraint.list özelliği long değerlerini içerecek ve diğer özellikler ayarlanmayacak.

"FIXED_LIST"
Belirli bir OptionType.FIXED değerleri listesindeki kısıtlama. OptionConstraint.list özelliği double değerlerini içerecek ve diğer özellikler ayarlanmayacak.

"STRING_LIST"
Belirli bir OptionType.STRING değerleri listesindeki kısıtlama. OptionConstraint.list özelliği DOMString değerlerini içerecek ve diğer özellikler ayarlanmayacak.

DeviceFilter

Chrome 125 ve sonraki sürümler

Özellikler

  • local

    boole isteğe bağlı

    Yalnızca doğrudan bilgisayara bağlı tarayıcıları döndürür.

  • güvenli

    boole isteğe bağlı

    Yalnızca USB veya TLS gibi güvenli bir aktarım kullanan tarayıcıları döndürün.

GetOptionGroupsResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • groups

    OptionGroup[] isteğe bağlı

    result, SUCCESS ise tarayıcı sürücüsü tarafından sağlanan sırayla seçenek gruplarının listesini verir.

  • Seçenek gruplarını alma işleminin sonucu. Bu değer SUCCESS ise groups özelliği doldurulur.

  • scannerHandle

    dize

    getOptionGroups işlevine iletilen tarayıcı tanıtıcısı.

GetScannerListResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • Numaralandırma sonucu. Bu bir hata olduğunu gösterse bile kısmi sonuçlar döndürülebileceğini unutmayın.

  • tarayıcılar

    ScannerInfo[]

    Sağlanan DeviceFilter ile eşleşen tarayıcıların listesi (boş olabilir).

OpenScannerResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • seçenekler

    isteğe bağlı nesne

    result, SUCCESS ise anahtarın cihaza özgü bir seçenek, değerin ise ScannerOption örneği olduğu bir anahtar/değer eşlemesi sağlar.

  • Tarayıcıyı açma işleminin sonucu. Bu değer SUCCESS ise scannerHandle ve options özellikleri doldurulur.

  • scannerHandle

    string isteğe bağlı

    result, SUCCESS ise tarayıcı için daha sonraki işlemlerde kullanılabilecek bir tanıtıcı.

  • scannerId

    dize

    Tarayıcı kimliği openScanner() değerine geçirildi.

OperationResult

Chrome 125 ve sonraki sürümler

Her işlemin sonucunu gösteren bir enum.

Enum

"UNKNOWN"
Bilinmeyen veya genel bir hata oluştu.

"SUCCESS"
İşlem başarılı oldu.

"UNSUPPORTED"
İşlem desteklenmiyor.

"CANCELLED"
İşlem iptal edildi.

"DEVICE_BUSY"
Cihaz meşgul.

"INVALID"
Veriler veya yönteme iletilen bir bağımsız değişken geçerli değil.

"WRONG_TYPE"
Sağlanan değer, temel seçenek için yanlış veri türüdür.

"EOF"
Başka veri yok.

"ADF_JAMMED"
Doküman besleyici sıkıştı.

"ADF_EMPTY"
Belge besleyici boş.

"COVER_OPEN"
Düz yatak kapağı açık.

"IO_ERROR"
Cihazla iletişim kurulurken bir hata oluştu.

"ACCESS_DENIED"
Cihaz için kimlik doğrulama gerekiyor.

"NO_MEMORY"
Chromebook'ta işlemi tamamlamak için yeterli bellek yok.

"UNREACHABLE"
Cihaza ulaşılamıyor.

"MISSING"
Cihazın bağlantısı kesildi.

"INTERNAL_ERROR"
Arayan uygulama dışında bir yerde hata oluştu.

OptionConstraint

Chrome 125 ve sonraki sürümler

Özellikler

  • list

    string[] | number[] isteğe bağlı

  • maks.

    number isteğe bağlı

  • dk

    number isteğe bağlı

  • quant

    number isteğe bağlı

OptionGroup

Chrome 125 ve sonraki sürümler

Özellikler

  • üyeler

    string[]

    Sürücü tarafından sağlanan sırada seçenek adları dizisi.

  • title

    dize

    Yazdırılabilir bir başlık sağlar (ör. "Geometri seçenekleri").

OptionSetting

Chrome 125 ve sonraki sürümler

Özellikler

  • ad

    dize

    Ayarlanacak seçeneğin adını belirtir.

  • tür

    OptionType

    Seçeneğin veri türünü belirtir. İstenen veri türü, temel seçeneğin gerçek veri türüyle eşleşmelidir.

  • value

    string | number | boolean | number[] isteğe bağlı

    Ayarlanacak değeri belirtir. autoSettable etkinleştirilmiş seçenekler için otomatik ayar isteğinde bulunmak üzere ayarlanmamış olarak bırakın. value için sağlanan veri türü type ile eşleşmelidir.

OptionType

Chrome 125 ve sonraki sürümler

Bir seçeneğin veri türü.

Enum

"UNKNOWN"
Seçeneğin veri türü bilinmiyor. value özelliği kaldırılacak.

"BOOL"
value özelliği truefalse değerlerinden biri olur.

"INT"
İşaretli 32 bit tam sayı. value özelliği, seçeneğin birden fazla değer alıp almadığına bağlı olarak long veya long[] olur.

"FIXED"
-32768 ile 32767,9999 aralığında, 1/65535 çözünürlüğe sahip bir double. value özelliği, seçeneğin birden fazla değer alıp almadığına bağlı olarak double veya double[] olur. Tam olarak temsil edilemeyen çift değerler, mevcut aralığa ve kesinliğe yuvarlanır.

"STRING"
NUL ('\0') hariç herhangi bir bayt dizisi. value özelliği bir DOMString olur.

"BUTTON"
Bu tür bir seçeneğin değeri yoktur. Bunun yerine, bu tür bir seçeneğin ayarlanması tarayıcı sürücüsünde seçeneğe özgü bir yan etkiye neden olur. Örneğin, düğme türü bir seçenek, varsayılan değerleri seçmek veya otomatik doküman besleyiciye bir sonraki kağıda geçmesini söylemek için tarayıcı sürücüsü tarafından kullanılabilir.

"GROUP"
Gruplandırma seçeneği. Değer yok. Bu, uyumluluk için dahil edilmiştir ancak normalde ScannerOption değerlerinde döndürülmez. getOptionGroups()Üye seçenekleriyle birlikte grupların listesini almak için bu yöntemi kullanın.

OptionUnit

Chrome 125 ve sonraki sürümler

ScannerOption.unit için veri türünü belirtir.

Enum

"UNITLESS"
Değer, birimsiz bir sayıdır. Örneğin, bir eşik olabilir.

"PIXEL"
Değer, piksel sayısıdır (ör. tarama boyutları).

"BIT"
Değer, bit sayısıdır (ör. renk derinliği).

"MM"
Değer, milimetre cinsinden ölçülür (ör. tarama boyutları).

"DPI"
Değer, inç başına nokta sayısı (ör. çözünürlük) olarak ölçülür.

"PERCENT"
Değer, parlaklık gibi bir yüzdedir.

"MICROSECOND"
Değer, mikrosaniye cinsinden ölçülür (ör. pozlama süresi).

ReadScanDataResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • veri

    ArrayBuffer isteğe bağlı

    result, SUCCESS ise taranan resim verilerinin sonraki parçasını içerir. result, EOF ise taranan görüntü verilerinin son parçasını içerir.

  • estimatedCompletion

    number isteğe bağlı

    result, SUCCESS ise toplam tarama verilerinin şu ana kadar ne kadarının yayınlandığına dair 0 ile 100 arasında bir tahmin.

  • iş

    dize

    readScanData() öğesine iletilen iş tanıtıcısını sağlar.

  • Veri okuma işleminin sonucu. Değeri SUCCESS ise data, okunmaya hazır olan sonraki (muhtemelen sıfır uzunlukta) resim verisi parçasını içerir. Değeri EOF ise data, resim verilerinin son parçasını içerir.

ScannerInfo

Chrome 125 ve sonraki sürümler

Özellikler

  • connectionType

    ConnectionType

    Tarayıcının bilgisayara nasıl bağlandığını gösterir.

  • deviceUuid

    dize

    Aynı fiziksel cihazı işaret eden diğer ScannerInfo girişleriyle eşleştirmek için kullanılır.

  • imageFormats

    string[]

    Döndürülen taramalar için istenebilecek MIME türleri dizisi.

  • üretici

    dize

    Tarayıcı üreticisi.

  • model

    dize

    Mevcutsa tarayıcı modeli veya genel bir açıklama.

  • ad

    dize

    Tarayıcının kullanıcı arayüzünde gösterilecek, kullanıcı tarafından okunabilen adı.

  • protocolType

    dize

    Tarayıcıya erişmek için kullanılan protokolün veya sürücünün (ör. Mopria, WSD veya epsonds) kullanıcılar tarafından okunabilir açıklaması. Bu, öncelikle bir cihazın birden fazla protokolü desteklemesi durumunda kullanıcının protokoller arasında seçim yapmasına olanak tanımak için kullanışlıdır.

  • scannerId

    dize

    Belirli bir tarayıcının kimliği.

  • güvenli

    boole

    Doğru değerine ayarlanırsa tarayıcı bağlantısının aktarımı, TLS veya USB gibi pasif bir dinleyici tarafından kesilemez.

ScannerOption

Chrome 125 ve sonraki sürümler

Özellikler

  • yapılandırılabilirlik

    Yapılandırılabilirlik

    Seçeneğin değiştirilip değiştirilemeyeceğini ve nasıl değiştirilebileceğini gösterir.

  • sınırlama

    OptionConstraint isteğe bağlı

    Mevcut tarayıcı seçeneğinde OptionConstraint değerini tanımlar.

  • açıklama

    dize

    Seçeneğin daha uzun bir açıklaması.

  • isActive

    boole

    Seçeneğin etkin olduğunu ve ayarlanabileceğini veya alınabileceğini gösterir. Yanlış değerine ayarlanırsa value özelliği ayarlanmaz.

  • isAdvanced

    boole

    Kullanıcı arayüzünün bu seçeneği varsayılan olarak göstermemesi gerektiğini belirtir.

  • isAutoSettable

    boole

    Tarayıcı sürücüsü tarafından otomatik olarak ayarlanabilir.

  • isDetectable

    boole

    Bu seçeneğin yazılım tarafından algılanabileceğini gösterir.

  • isEmulated

    boole

    Doğru ise tarayıcı sürücüsü tarafından emüle edilir.

  • ad

    dize

    Küçük harfli ASCII harfleri, rakamlar ve kısa çizgiler kullanılarak oluşturulan seçenek adı. Aksan işaretlerine izin verilmez.

  • title

    dize

    Yazdırılabilir tek satırlık başlık.

  • tür

    OptionType

    Bu seçeneği ayarlamak için gereken value özelliğinde bulunan veri türü.

  • birim

    OptionUnit

    Bu seçeneğin ölçü birimi.

  • value

    string | number | boolean | number[] isteğe bağlı

    Seçeneğin mevcut değeri (varsa). Bu özelliğin veri türünün, type içinde belirtilen veri türüyle eşleşmesi gerektiğini unutmayın.

ScanOptions

Özellikler

  • maxImages

    number isteğe bağlı

    İzin verilen taranmış resim sayısı. Varsayılan değer 1'dir.

  • mimeTypes

    string[] isteğe bağlı

    Arayan tarafından kabul edilen MIME türleri.

ScanResults

Özellikler

  • dataUrls

    string[]

    Bir resim etiketine "src" değeri olarak iletilebilecek biçimdeki veri resmi URL'leri dizisi.

  • mimeType

    dize

    dataUrls öğesinin MIME türü.

SetOptionResult

Chrome 125 ve sonraki sürümler

Özellikler

  • ad

    dize

    Ayarlanan seçeneğin adını belirtir.

  • Seçeneği ayarlamanın sonucunu gösterir.

SetOptionsResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • seçenekler

    isteğe bağlı nesne

    Sağlanan tüm seçenekleri ayarlamaya çalıştıktan sonra yeni yapılandırmayı içeren, seçenek adlarından ScannerOption değerlerine güncellenmiş bir anahtar/değer eşlemesi. Bu, OpenScannerResponse içindeki options özelliğiyle aynı yapıya sahiptir.

    Bazı seçenekler başarıyla ayarlanmamış olsa bile bu özellik ayarlanır ancak güncellenen yapılandırma alınamazsa (örneğin, tarama sırasında tarayıcının bağlantısı kesilirse) ayarlanmaz.

  • sonuç

    SetOptionResult[]

    Her bir OptionSetting için birer tane olmak üzere sonuç dizisi.

  • scannerHandle

    dize

    setOptions() işlevine iletilen tarayıcı tanıtıcısını sağlar.

StartScanOptions

Chrome 125 ve sonraki sürümler

Özellikler

  • biçim

    dize

    Taranan verilerin döndürüleceği MIME türünü belirtir.

  • maxReadSize

    number isteğe bağlı

    Sıfır dışında bir değer belirtilirse tek bir readScanData yanıtında döndürülen taranmış maksimum bayt sayısını bu değerle sınırlandırır. İzin verilen en küçük değer 32768'dir (32 KB). Bu özellik belirtilmezse döndürülen parçanın boyutu, taranan resmin tamamı kadar büyük olabilir.

StartScanResponse

Chrome 125 ve sonraki sürümler

Özellikler

  • iş

    string isteğe bağlı

    result, SUCCESS ise tarama verilerini okumak veya işi iptal etmek için kullanılabilecek bir tutma yeri sağlar.

  • Tarama başlatma işleminin sonucu. Bu değer SUCCESS ise job özelliği doldurulur.

  • scannerHandle

    dize

    startScan() işlevine iletilen tarayıcı tutma yerinin aynısını sağlar.

Yöntemler

cancelScan()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.cancelScan(
  job: string,
  callback?: function,
): Promise<CancelScanResponse>

Başlatılan bir taramayı iptal eder ve CancelScanResponse nesnesiyle çözümlenen bir Promise döndürür. Geri çağırma kullanılıyorsa nesne bunun yerine geri çağırmaya iletilir.

Parametreler

  • iş

    dize

    Daha önce startScan çağrısından döndürülen etkin bir tarama işinin herkese açık kullanıcı adı.

  • callback

    function isteğe bağlı

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

    (response: CancelScanResponse) => void

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

closeScanner()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.closeScanner(
  scannerHandle: string,
  callback?: function,
): Promise<CloseScannerResponse>

Tarayıcıyı, iletilen tutma yeriyle kapatır ve CloseScannerResponse nesnesiyle çözümlenen bir Promise döndürür. Geri çağırma kullanılıyorsa nesne bunun yerine geri çağırmaya iletilir. Yanıt başarılı olmasa bile, sağlanan tutma yeri geçersiz hale gelir ve başka işlemler için kullanılmamalıdır.

Parametreler

  • scannerHandle

    dize

    Daha önce openScanner çağrısından döndürülen açık bir tarayıcının tutma yerini belirtir.

  • callback

    function isteğe bağlı

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

    (response: CloseScannerResponse) => void

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getOptionGroups()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.getOptionGroups(
  scannerHandle: string,
  callback?: function,
): Promise<GetOptionGroupsResponse>

openScanner tarafından daha önce açılmış bir tarayıcıdan grup adlarını ve üye seçeneklerini alır. Bu yöntem, GetOptionGroupsResponse nesnesiyle çözümlenen bir Promise döndürür. Bu işleve bir geri çağırma iletilirse döndürülen veriler bunun yerine geri çağırmaya iletilir.

Parametreler

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getScannerList()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.getScannerList(
  filter: DeviceFilter,
  callback?: function,
): Promise<GetScannerListResponse>

Kullanılabilir tarayıcıların listesini alır ve GetScannerListResponse nesnesiyle çözümlenen bir Promise döndürür. Bu işleve bir geri çağırma iletilirse döndürülen veriler bunun yerine geri çağırmaya iletilir.

Parametreler

İadeler

  • Sonuç ve tarayıcı listesiyle çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

openScanner()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.openScanner(
  scannerId: string,
  callback?: function,
): Promise<OpenScannerResponse>

Özel erişim için bir tarayıcı açar ve OpenScannerResponse nesnesiyle çözümlenen bir Promise döndürür. Bu işleve bir geri çağırma iletilirse döndürülen veriler bunun yerine geri çağırmaya iletilir.

Parametreler

  • scannerId

    dize

    Açılacak tarayıcının kimliği. Bu değer, önceki bir getScannerList çağrısından döndürülen değerdir.

  • callback

    function isteğe bağlı

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

    (response: OpenScannerResponse) => void

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

readScanData()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.readScanData(
  job: string,
  callback?: function,
): Promise<ReadScanDataResponse>

Etkin bir iş tanıtıcısından mevcut resim verilerinin bir sonraki parçasını okur ve ReadScanDataResponse nesnesiyle çözümlenen bir Promise döndürür. Geri çağırma kullanılıyorsa nesne bunun yerine geri çağırmaya iletilir.

**Not:**Yanıt sonucunun sıfır uzunlukta bir data üyesiyle SUCCESS olması geçerlidir. Bu, tarayıcının hâlâ çalıştığı ancak henüz ek verilerin hazır olmadığı anlamına gelir. Arayan kişi kısa bir süre bekleyip tekrar denemelidir.

Tarama işi tamamlandığında yanıt, EOF sonuç değerini alır. Bu yanıt, sıfır olmayan son bir data üyesi içerebilir.

Parametreler

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

scan()

Taahhüt 
chrome.documentScan.scan(
  options: ScanOptions,
  callback?: function,
): Promise<ScanResults>

Belge tarama işlemi gerçekleştirir ve ScanResults nesnesiyle çözümlenen bir Promise döndürür. Bu işleve bir geri çağırma iletilirse döndürülen veriler bunun yerine geri çağırmaya iletilir.

Parametreler

  • seçenekler

    ScanOptions

    Tarama parametrelerini içeren bir nesne.

  • callback

    function isteğe bağlı

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

    (result: ScanResults) => void

İadeler

  • Promise<ScanResults>

    Chrome 96+

    Tarama sonuçlarıyla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setOptions()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.setOptions(
  scannerHandle: string,
  options: OptionSetting[],
  callback?: function,
): Promise<SetOptionsResponse>

Belirtilen tarayıcıda seçenekleri ayarlar ve iletilen OptionSetting nesnesinin sırasına göre her değeri ayarlama denemesinin sonucunu içeren bir SetOptionsResponse nesnesiyle çözümlenen bir Promise döndürür. Geri çağırma kullanılıyorsa nesne bunun yerine geri çağırmaya iletilir.

Parametreler

  • scannerHandle

    dize

    Seçeneklerin ayarlanacağı tarayıcının herkese açık adı. Bu, daha önce openScanner çağrısından döndürülen bir değer olmalıdır.

  • seçenekler

    OptionSetting[]

    Tarayıcıya uygulanacak OptionSetting nesnenin listesi.

  • callback

    function isteğe bağlı

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

    (response: SetOptionsResponse) => void

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

startScan()

Promise Chrome 125 ve sonraki sürümler 
chrome.documentScan.startScan(
  scannerHandle: string,
  options: StartScanOptions,
  callback?: function,
): Promise<StartScanResponse>

Belirtilen tarayıcıda bir tarama başlatır ve StartScanResponse ile çözümlenen bir Promise döndürür. Geri çağırma kullanılıyorsa nesne bunun yerine geri çağırmaya iletilir. Çağrı başarılı olursa yanıt, tarama verilerini okumak veya taramayı iptal etmek için sonraki çağrılarda kullanılabilecek bir iş tanıtıcısı içerir.

Parametreler

  • scannerHandle

    dize

    Açık bir tarayıcının tutma yeri. Bu, daha önce openScanner çağrısından döndürülen bir değer olmalıdır.

  • seçenekler

    StartScanOptions

    Tarama için kullanılacak seçenekleri belirten bir StartScanOptions nesnesi. StartScanOptions.format özelliği, tarayıcının ScannerInfo özelliğinde döndürülen girişlerden biriyle eşleşmelidir.

  • callback

    function isteğe bağlı

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

    (response: StartScanResponse) => void

İadeler

  • Sonuçla çözümlenen bir Promise döndürür.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.