chrome.documentScan

תיאור

אפשר להשתמש ב-chrome.documentScan API כדי לגלות ולאחזר תמונות מסורקי מסמכים שמחוברים למכשיר.

הרשאות

documentScan

זמינות

‫Chrome 44 ואילך ChromeOS בלבד

Document Scan API

ממשק ה-API של סריקת המסמכים נועד לאפשר לאפליקציות ולתוספים לצפות בתוכן של מסמכים מודפסים בסורק מסמכים שמחובר למחשב.

סוגים

CancelScanResponse

‫Chrome 125 ואילך

מאפיינים

  • משימה

    מחרוזת

    מחזירה את אותו ה-handle של המשימה שהועבר אל cancelScan().

  • תוצאה

    OperationResult

    תוצאת ביטול הסריקה בשרת העורפי. אם התוצאה היא OperationResult.SUCCESS או OperationResult.CANCELLED, הסריקה בוטלה והסורק מוכן להתחיל סריקה חדשה. אם התוצאה היא OperationResult.DEVICE_BUSY , הסורק עדיין מעבד את בקשת הביטול. המתקשר צריך להמתין זמן קצר ולנסות שוב לשלוח את הבקשה. ערכי תוצאה אחרים מציינים שגיאה קבועה שלא כדאי לנסות שוב.

CloseScannerResponse

‫Chrome 125 ואילך

מאפיינים

  • תוצאה

    OperationResult

    התוצאה של סגירת הסורק. גם אם הערך הזה לא SUCCESS, ה-handle יהיה לא תקין ולא יהיה אפשר להשתמש בו לפעולות נוספות.

  • scannerHandle

    מחרוזת

    אותו ה-handle של הסורק שהועבר אל closeScanner.

Configurability

‫Chrome 125 ואילך

איך אפשר לשנות אפשרות.

Enum

‫NOT_CONFIGURABLE
האפשרות היא לקריאה בלבד.

‫SOFTWARE_CONFIGURABLE
אפשר להגדיר את האפשרות בתוכנה.

‫HARDWARE_CONFIGURABLE
המשתמש יכול להגדיר את האפשרות באמצעות החלפה או לחיצה על לחצן בסורק.

ConnectionType

‫Chrome 125 ואילך

מציין איך הסורק מחובר למחשב.

Enum

‫"UNSPECIFIED"

‪"USB"

‪"NETWORK"

ConstraintType

‫Chrome 125 ואילך

סוג הנתונים של האילוץ שמיוצג על ידי OptionConstraint.

Enum

‫INT_RANGE
ההגבלה על טווח של ערכי OptionType.INT. המאפיינים min,‏ max ו-quant של OptionConstraint יהיו long, והמאפיין list שלו לא יוגדר.

‫FIXED_RANGE
ההגבלה על טווח של ערכי OptionType.FIXED. המאפיינים min,‏ max ו-quant של OptionConstraint יהיו double, והמאפיין list שלו לא יוגדר.

‫"INT_LIST"
ההגבלה על רשימה ספציפית של ערכי OptionType.INT. המאפיין OptionConstraint.list יכיל ערכים של long, והמאפיינים האחרים לא יוגדרו.

‫FIXED_LIST
ההגבלה על רשימה ספציפית של ערכי OptionType.FIXED. המאפיין OptionConstraint.list יכיל ערכים של double, והמאפיינים האחרים לא יוגדרו.

‫STRING_LIST
ההגבלה על רשימה ספציפית של ערכי OptionType.STRING. המאפיין OptionConstraint.list יכיל ערכים של DOMString, והמאפיינים האחרים לא יוגדרו.

DeviceFilter

‫Chrome 125 ואילך

מאפיינים

  • local

    ‫boolean אופציונלי

    יוחזרו רק סורקים שמחוברים ישירות למחשב.

  • מאובטח

    ‫boolean אופציונלי

    החזרת סורקים שמשתמשים בהעברה מאובטחת, כמו USB או TLS.

GetOptionGroupsResponse

‫Chrome 125 ואילך

מאפיינים

  • קבוצות

    ‫OptionGroup[] optional

    אם result הוא SUCCESS, מוצגת רשימה של קבוצות אפשרויות לפי הסדר שסופק על ידי מנהל ההתקן של הסורק.

  • תוצאה

    OperationResult

    התוצאה של קבלת קבוצות האפשרויות. אם הערך של המאפיין הזה הוא SUCCESS, המאפיין groups יאוכלס.

  • scannerHandle

    מחרוזת

    אותו ה-handle של הסורק שהועבר אל getOptionGroups.

GetScannerListResponse

‫Chrome 125 ואילך

מאפיינים

  • תוצאה

    OperationResult

    תוצאת הספירה. שימו לב: יכול להיות שיוחזרו תוצאות חלקיות גם אם השגיאה הזו מצוינת.

  • סורקים

    ScannerInfo[]

    רשימה של סורקים שתואמים ל-DeviceFilter שצוין. הרשימה יכולה להיות ריקה.

OpenScannerResponse

‫Chrome 125 ואילך

מאפיינים

  • options

    אובייקט אופציונלי

    אם result הוא SUCCESS, הפונקציה מספקת מיפוי של מפתח/ערך, כאשר המפתח הוא אפשרות ספציפית למכשיר והערך הוא מופע של ScannerOption.

  • תוצאה

    OperationResult

    התוצאה של פתיחת הסורק. אם הערך של המאפיין הזה הוא SUCCESS, המאפיינים scannerHandle ו-options יאוכלסו.

  • scannerHandle

    מחרוזת אופציונלי

    אם result הוא SUCCESS, מחזיק (handle) של הסורק שאפשר להשתמש בו לפעולות נוספות.

  • scannerId

    מחרוזת

    מזהה הסורק הועבר אל openScanner().

OperationResult

‫Chrome 125 ואילך

סוג enum שמציין את התוצאה של כל פעולה.

Enum

‫UNKNOWN
אירעה שגיאה כללית או שגיאה לא ידועה.

‫"SUCCESS"
הפעולה בוצעה בהצלחה.

‫UNSUPPORTED
הפעולה לא נתמכת.

"בוטלה"
הפעולה בוטלה.

‫DEVICE_BUSY
המכשיר תפוס.

‫"INVALID"
הנתונים או הארגומנט שהועבר לשיטה לא תקינים.

‫"WRONG_TYPE"
הערך שסופק הוא סוג הנתונים הלא נכון לאפשרות הבסיסית.

‫EOF
אין יותר נתונים זמינים.

‫"ADF_JAMMED"
מזין המסמכים תקוע.

‫"ADF_EMPTY"
מזין המסמכים ריק.

‫"COVER_OPEN"
המכסה של הסורק השטוח פתוח.

‫IO_ERROR
אירעה שגיאה במהלך התקשורת עם המכשיר.

‫ACCESS_DENIED
נדרש אימות של המכשיר.

‫"NO_MEMORY"
אין מספיק זיכרון ב-Chromebook כדי להשלים את הפעולה.

‫UNREACHABLE
לא ניתן לגשת למכשיר.

‫MISSING
המכשיר מנותק.

‫INTERNAL_ERROR
אירעה שגיאה במקום אחר ולא באפליקציה שמבצעת את הקריאה.

OptionConstraint

‫Chrome 125 ואילך

מאפיינים

  • list

    ‫string[] | number[] אופציונלי

  • מקסימלי

    מספר אופציונלי

  • דק'

    מספר אופציונלי

  • quant

    מספר אופציונלי

OptionGroup

‫Chrome 125 ואילך

מאפיינים

  • חברים

    string[]

    מערך של שמות אפשרויות בסדר שסופק על ידי הנהג.

  • title

    מחרוזת

    מציין שם שאפשר להדפיס, למשל 'אפשרויות גיאומטריה'.

OptionSetting

‫Chrome 125 ואילך

מאפיינים

  • שם

    מחרוזת

    מציין את שם האפשרות להגדרה.

  • סוג

    OptionType

    מציין את סוג הנתונים של האפשרות. סוג הנתונים המבוקש צריך להיות זהה לסוג הנתונים בפועל של האפשרות הבסיסית.

  • ערך

    string | number | boolean | number[] optional

    מציין את הערך להגדרה. אם לא מגדירים את האפשרות הזו, המערכת מבקשת הגדרה אוטומטית לאפשרויות שמוגדרות כautoSettable. סוג הנתונים שצוין עבור value חייב להיות זהה ל-type.

OptionType

‫Chrome 125 ואילך

סוג הנתונים של האפשרות.

Enum

‫"UNKNOWN"
סוג הנתונים של האפשרות לא ידוע. המאפיין value לא יוגדר.

‫BOOL
המאפיין value יהיה אחד מהערכים truefalse.

‫INT
מספר שלם חתום בן 32 ביט. המאפיין value יהיה long או long[], בהתאם לשאלה אם האפשרות מקבלת יותר מערך אחד.

‫FIXED
מספר כפול בטווח ‎-32768-32767.9999 עם רזולוציה של ‎1/65535. המאפיין value יהיה double או double[] ‎, בהתאם לשאלה אם האפשרות מקבלת יותר מערך אחד. ערכים מסוג double שלא ניתן לייצג בדיוק יעוגלו לטווח ולדיוק הזמינים.

‫"STRING"
רצף של בייטים כלשהם, חוץ מ-NUL (‎'\0'). המאפיין value יהיה DOMString.

‫"BUTTON"
לאפשרות מסוג זה אין ערך. במקום זאת, הגדרת אפשרות מהסוג הזה גורמת לתופעת לוואי ספציפית לאפשרות במנהל ההתקן של הסורק. לדוגמה, מנהל התקן של סורק יכול להשתמש באפשרות מסוג לחצן כדי לספק אמצעי לבחירת ערכי ברירת מחדל או כדי להנחות מזין מסמכים אוטומטי לעבור לדף הבא.

‫GROUP
אפשרות הקיבוץ. אין ערך. הוא נכלל לצורך תאימות, אבל בדרך כלל לא יוחזר בערכים של ScannerOption. משתמשים ב-getOptionGroups() כדי לאחזר את רשימת הקבוצות עם אפשרויות החברים שלהן.

OptionUnit

‫Chrome 125 ואילך

מציין את סוג הנתונים של ScannerOption.unit.

Enum

‫UNITLESS
הערך הוא מספר ללא יחידה. לדוגמה, יכול להיות שזה ערך סף.

‫"PIXEL"
הערך הוא מספר פיקסלים, לדוגמה, מידות סריקה.

‫BIT
הערך הוא מספר הביטים, למשל עומק הצבע.

‫MM
הערך נמדד במילימטרים, למשל מידות סריקה.

‫‎"DPI"
הערך נמדד בנקודות לאינץ', לדוגמה, רזולוציה.

‫PERCENT
הערך הוא אחוז, למשל בהירות.

‫'MICROSECOND'
הערך נמדד במיקרו-שניות, למשל זמן החשיפה.

ReadScanDataResponse

‫Chrome 125 ואילך

מאפיינים

  • נתונים

    ‫ArrayBuffer אופציונלי

    אם result הוא SUCCESS, מכיל את המקטע הבא של נתוני תמונות שנסרקו. אם result הוא EOF, מכיל את נתוני התמונה הסרוקים האחרונים.

  • estimatedCompletion

    מספר אופציונלי

    אם הערך של result הוא SUCCESS, מוצגת הערכה של כמות הנתונים הכוללת שנסרקה ונמסרה עד עכשיו, בטווח 0 עד 100.

  • משימה

    מחרוזת

    השירות הזה מספק את ה-handle של העבודה שהועבר ל-readScanData().

  • תוצאה

    OperationResult

    התוצאה של קריאת הנתונים. אם הערך שלו הוא SUCCESS, אז data מכיל את נתוני התמונה הבאים (יכול להיות שאין נתונים). אם הערך שלו הוא EOF, data מכיל את נתוני התמונה האחרונים.

ScannerInfo

‫Chrome 125 ואילך

מאפיינים

  • connectionType

    ConnectionType

    מציין איך הסורק מחובר למחשב.

  • deviceUuid

    מחרוזת

    לצורך התאמה לערכים אחרים של ScannerInfo שמפנים לאותו מכשיר פיזי.

  • imageFormats

    string[]

    מערך של סוגי MIME שאפשר לבקש עבור סריקות שמוחזרות.

  • יצרן

    מחרוזת

    יצרן הסורק.

  • מודל

    מחרוזת

    מודל הסורק אם הוא זמין, או תיאור כללי.

  • שם

    מחרוזת

    שם קריא לאנשים של הסורק שיוצג בממשק המשתמש.

  • protocolType

    מחרוזת

    תיאור קריא לאנשים של הפרוטוקול או מנהל ההתקן שמשמשים לגישה לסורק, כמו Mopria,‏ WSD או epsonds. האפשרות הזו שימושית בעיקר כדי לאפשר למשתמש לבחור בין פרוטוקולים אם מכשיר תומך בכמה פרוטוקולים.

  • scannerId

    מחרוזת

    המזהה של סורק ספציפי.

  • מאובטח

    בוליאני

    אם הערך הוא true, אי אפשר ליירט את התעבורה של חיבור הסורק על ידי מאזין פסיבי, כמו TLS או USB.

ScannerOption

‫Chrome 125 ואילך

מאפיינים

  • יכולת הגדרה

    אפשרויות ההגדרה

    מציין אם אפשר לשנות את האפשרות ואיך.

  • מגבלה

    ‫OptionConstraint optional

    הגדרת OptionConstraint באפשרות הסורק הנוכחית.

  • תיאור

    מחרוזת

    תיאור ארוך יותר של האפשרות.

  • isActive

    בוליאני

    מציין שהאפשרות פעילה וניתן להגדיר או לאחזר אותה. אם הערך הוא False, המאפיין value לא יוגדר.

  • isAdvanced

    בוליאני

    מציין שהאפשרות הזו לא תוצג בממשק המשתמש כברירת מחדל.

  • isAutoSettable

    בוליאני

    יכול להיות שיוגדר אוטומטית על ידי מנהל ההתקן של הסורק.

  • isDetectable

    בוליאני

    מציין שאפשר לזהות את האפשרות הזו מתוכנה.

  • isEmulated

    בוליאני

    ההגדרה הזו מדומה על ידי מנהל ההתקן של הסורק אם היא מוגדרת כ-True.

  • שם

    מחרוזת

    שם האפשרות באותיות קטנות של ASCII, מספרים ומקפים. אסור להשתמש בסימני ניקוד.

  • title

    מחרוזת

    כותרת בת שורה אחת שאפשר להדפיס.

  • סוג

    OptionType

    סוג הנתונים שכלול במאפיין value, שנדרש להגדרת האפשרות הזו.

  • יחידה

    OptionUnit

    יחידת המידה של האפשרות הזו.

  • ערך

    string | number | boolean | number[] optional

    הערך הנוכחי של האפשרות, אם רלוונטי. שימו לב שסוג הנתונים של המאפיין הזה צריך להיות זהה לסוג הנתונים שצוין ב-type.

ScanOptions

מאפיינים

  • maxImages

    מספר אופציונלי

    מספר התמונות הסרוקות המותר. ערך ברירת המחדל הוא 1.

  • mimeTypes

    string[] אופציונלי

    סוגי ה-MIME שהמתקשר מקבל.

ScanResults

מאפיינים

  • dataUrls

    string[]

    מערך של כתובות URL של תמונות נתונים בפורמט שאפשר להעביר כערך של 'src' לתג תמונה.

  • mimeType

    מחרוזת

    סוג ה-MIME של dataUrls.

SetOptionResult

‫Chrome 125 ואילך

מאפיינים

  • שם

    מחרוזת

    מציין את השם של האפשרות שהוגדרה.

  • תוצאה

    OperationResult

    מציין את התוצאה של הגדרת האפשרות.

SetOptionsResponse

‫Chrome 125 ואילך

מאפיינים

  • options

    אובייקט אופציונלי

    מיפוי מעודכן של זוגות מפתח/ערך משמות של אפשרויות לערכים של ScannerOption, שמכיל את ההגדרה החדשה אחרי ניסיון להגדיר את כל האפשרויות שסופקו. המבנה של המאפיין הזה זהה למבנה של המאפיין options ב-OpenScannerResponse.

    המאפיין הזה יוגדר גם אם חלק מהאפשרויות לא הוגדרו בהצלחה, אבל הוא לא יוגדר אם אחזור ההגדרה המעודכנת ייכשל (לדוגמה, אם הסורק ינותק באמצע הסריקה).

  • תוצאות

    SetOptionResult[]

    מערך של תוצאות, אחת לכל OptionSetting שהועבר.

  • scannerHandle

    מחרוזת

    השירות הזה מספק את הטיפול בסורק שמועבר אל setOptions().

StartScanOptions

‫Chrome 125 ואילך

מאפיינים

  • פורמט

    מחרוזת

    מציין את סוג ה-MIME שבו יוחזרו הנתונים שנסרקו.

  • maxReadSize

    מספר אופציונלי

    אם מציינים ערך שאינו אפס, הערך הזה מגביל את מספר הבייטים המקסימלי שנסרקו ומוחזרים בתשובה אחת של readScanData. הערך הקטן ביותר המותר הוא 32768 (32KB). אם לא מציינים את המאפיין הזה, גודל החלק שמוחזר יכול להיות גדול כמו התמונה הסרוקה כולה.

StartScanResponse

‫Chrome 125 ואילך

מאפיינים

  • משימה

    מחרוזת אופציונלי

    אם result הוא SUCCESS, הפונקציה מספקת נקודת אחיזה שאפשר להשתמש בה כדי לקרוא נתוני סריקה או לבטל את העבודה.

  • תוצאה

    OperationResult

    התוצאה של הפעלת סריקה. אם הערך של המאפיין הזה הוא SUCCESS, המאפיין job יאוכלס.

  • scannerHandle

    מחרוזת

    מחזירה את אותו ה-handle של הסורק שהועבר אל startScan().

Methods

cancelScan()

Promise Chrome 125+ 
chrome.documentScan.cancelScan(
  job: string,
  callback?: function,
): Promise<CancelScanResponse>

מבטל סריקה שהתחילה ומחזיר Promise שמוחזר עם אובייקט CancelScanResponse. אם נעשה שימוש בפונקציית קריאה חוזרת, האובייקט מועבר אליה במקום זאת.

פרמטרים

  • משימה

    מחרוזת

    ה-handle של משימת סריקה פעילה שהוחזר קודם מקריאה אל startScan.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (response: CancelScanResponse) => void

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

closeScanner()

Promise Chrome 125+ 
chrome.documentScan.closeScanner(
  scannerHandle: string,
  callback?: function,
): Promise<CloseScannerResponse>

סוגרת את הסורק עם ה-handle שהועבר ומחזירה Promise שמסתיימת עם אובייקט CloseScannerResponse. אם נעשה שימוש בפונקציית קריאה חוזרת, האובייקט מועבר אליה במקום זאת. גם אם התגובה לא מציינת שהפעולה בוצעה בהצלחה, ה-handle שסופק הופך ללא תקף ואין להשתמש בו לפעולות נוספות.

פרמטרים

  • scannerHandle

    מחרוזת

    מציין את ה-handle של סורק פתוח שהוחזר קודם מקריאה ל-openScanner.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (response: CloseScannerResponse) => void

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

getOptionGroups()

Promise Chrome 125+ 
chrome.documentScan.getOptionGroups(
  scannerHandle: string,
  callback?: function,
): Promise<GetOptionGroupsResponse>

מקבל את שמות הקבוצות ואת אפשרויות החברים מסורק שנפתח קודם על ידי openScanner. השיטה הזו מחזירה Promise שמסתיימת עם אובייקט GetOptionGroupsResponse. אם מעבירים פונקציית קריאה חוזרת לפונקציה הזו, הנתונים שמוחזרים מועברים אליה במקום זאת.

פרמטרים

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

getScannerList()

Promise Chrome 125+ 
chrome.documentScan.getScannerList(
  filter: DeviceFilter,
  callback?: function,
): Promise<GetScannerListResponse>

מקבל את רשימת הסורקים הזמינים ומחזיר Promise שמוביל לאובייקט GetScannerListResponse. אם מעבירים פונקציית קריאה חוזרת לפונקציה הזו, הנתונים שמוחזרים מועברים אליה במקום זאת.

פרמטרים

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

openScanner()

Promise Chrome 125+ 
chrome.documentScan.openScanner(
  scannerId: string,
  callback?: function,
): Promise<OpenScannerResponse>

פותחת סורק לגישה בלעדית ומחזירה Promise שמוביל לאובייקט OpenScannerResponse. אם מעבירים פונקציית קריאה חוזרת לפונקציה הזו, הנתונים שמוחזרים מועברים אליה במקום זאת.

פרמטרים

  • scannerId

    מחרוזת

    המזהה של הסורק שרוצים לפתוח. הערך הזה הוא אחד מהערכים שמוחזרים מקריאה קודמת ל-getScannerList.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (response: OpenScannerResponse) => void

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

readScanData()

Promise Chrome 125+ 
chrome.documentScan.readScanData(
  job: string,
  callback?: function,
): Promise<ReadScanDataResponse>

קוראת את הנתח הבא של נתוני התמונה הזמינים מתוך נקודת אחיזה של משימה פעילה, ומחזירה הבטחה (Promise) שמושלמת עם אובייקט ReadScanDataResponse. אם נעשה שימוש בפונקציית קריאה חוזרת, האובייקט מועבר אליה במקום זאת.

**הערה:**תקין שתוצאת התגובה תהיה SUCCESS עם חבר data באורך אפס. המשמעות היא שהסורק עדיין פועל אבל אין עדיין נתונים נוספים מוכנים. המתקשר צריך להמתין זמן קצר ולנסות שוב.

כשעבודת הסריקה מסתיימת, ערך התוצאה בתגובה הוא EOF. יכול להיות שהתשובה הזו תכיל ערך סופי של data שאינו אפס.

פרמטרים

  • משימה

    מחרוזת

    הכינוי של המשימה הפעילה הוחזר בעבר מ-startScan.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (response: ReadScanDataResponse) => void

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

scan()

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

מבצעת סריקת מסמך ומחזירה Promise שמוביל לאובייקט ScanResults. אם מעבירים פונקציית קריאה חוזרת לפונקציה הזו, הנתונים שמוחזרים מועברים אליה במקום זאת.

פרמטרים

  • options

    ScanOptions

    אובייקט שמכיל פרמטרים של סריקה.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: ScanResults) => void

החזרות

  • Promise<ScanResults>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

setOptions()

Promise Chrome 125+ 
chrome.documentScan.setOptions(
  scannerHandle: string,
  options: OptionSetting[],
  callback?: function,
): Promise<SetOptionsResponse>

מגדירה אפשרויות בסורק שצוין ומחזירה הבטחה (Promise) שנפתרת עם אובייקט SetOptionsResponse שמכיל את התוצאה של הניסיון להגדיר כל ערך בסדר של אובייקט OptionSetting שהועבר. אם נעשה שימוש בפונקציית קריאה חוזרת, האובייקט מועבר אליה במקום זאת.

פרמטרים

  • scannerHandle

    מחרוזת

    ה-handle של הסורק שרוצים להגדיר לו אפשרויות. הערך הזה צריך להיות ערך שהוחזר בעבר מקריאה אל openScanner.

  • options

    OptionSetting[]

    רשימה של OptionSetting אובייקטים שיוחלו על הסורק.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (response: SetOptionsResponse) => void

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

startScan()

Promise Chrome 125+ 
chrome.documentScan.startScan(
  scannerHandle: string,
  options: StartScanOptions,
  callback?: function,
): Promise<StartScanResponse>

מתחילה סריקה בסורק שצוין ומחזירה הבטחה (Promise) שמושלמת עם StartScanResponse. אם נעשה שימוש בפונקציית קריאה חוזרת, האובייקט מועבר אליה במקום זאת. אם הקריאה מצליחה, התשובה כוללת את ה-handle של העבודה שאפשר להשתמש בו בקריאות הבאות כדי לקרוא את נתוני הסריקה או לבטל את הסריקה.

פרמטרים

  • scannerHandle

    מחרוזת

    ידית של סורק פתוח. הערך הזה צריך להיות ערך שהוחזר בעבר מקריאה אל openScanner.

  • אובייקט StartScanOptions שמציין את האפשרויות שבהן יש להשתמש בסריקה. הערך של המאפיין StartScanOptions.format צריך להיות זהה לאחד מהערכים שמוחזרים ב-ScannerInfo של הסורק.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (response: StartScanResponse) => void

החזרות

  • ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.