chrome.documentScan

الوصف

يمكنك استخدام واجهة برمجة التطبيقات chrome.documentScan API لاكتشاف الصور واستردادها من الماسحات الضوئية للمستندات المرفقة.

الأذونات

documentScan

مدى التوفّر

Chrome 44 والإصدارات الأحدث ChromeOS فقط

واجهة برمجة التطبيقات لفحص المستندات

تم تصميم واجهة برمجة التطبيقات Document Scan API للسماح للتطبيقات والإضافات بعرض محتوى المستندات الورقية على الماسح الضوئي للمستندات المرفقة.

الأنواع

CancelScanResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • وظيفة

    سلسلة

    يقدّم الاسم المعرِّف الوظيفي نفسه الذي تم إرساله إلى "cancelScan()".

  • نتيجة

    OperationResult

    نتيجة البحث عن إلغاء في الخلفية إذا كانت النتيجة OperationResult.SUCCESS أو OperationResult.CANCELLED، هذا يعني أنّه تم إلغاء المسح الضوئي وسيصبح الماسح الضوئي جاهزًا لبدء عملية فحص جديدة. إذا كانت النتيجة OperationResult.DEVICE_BUSY، يعني ذلك أنّ الماسح الضوئي لا يزال يعالج عملية الإلغاء المطلوبة، ومن المفترض أن ينتظر المتصل وقتًا قصيرًا ويحاول مرة أخرى الطلب. تشير قيم النتائج الأخرى إلى خطأ دائم يجب عدم إعادة المحاولة.

CloseScannerResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • نتيجة

    OperationResult

    نتيجة إغلاق الماسح الضوئي. حتى إذا لم تكن هذه القيمة SUCCESS، سيكون الاسم المعرِّف غير صالح ويجب عدم استخدامه في أي عمليات أخرى.

  • scannerHandle

    سلسلة

    مقبض الماسح الضوئي نفسه الذي تم تمريره إلى closeScanner.

Configurability

Chrome 125 والإصدارات الأحدث

كيفية تغيير أحد الخيارات

التعداد

"NOT_CONFIGURABLE"
هذا الخيار للقراءة فقط.

"Software_CONFIGURABLE"
يمكن ضبط هذا الخيار في البرنامج.

"HARDWARE_CONFIGURABLE"
يمكن تحديد هذا الخيار عن طريق المستخدم تفعيل أو الضغط على زر في الماسح الضوئي.

ConnectionType

Chrome 125 والإصدارات الأحدث

يشير إلى كيفية اتصال الماسح الضوئي بالكمبيوتر.

التعداد

"USB"

ConstraintType

Chrome 125 والإصدارات الأحدث

نوع البيانات للقيد الذي يمثّله OptionConstraint.

التعداد

"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

    منطقية اختيارية

    إرجاع الماسحات الضوئية المتصلة مباشرةً بجهاز الكمبيوتر فقط.

  • آمن

    منطقية اختيارية

    إرجاع الماسحات الضوئية التي تستخدم عملية نقل آمنة فقط، مثل USB أو بروتوكول أمان طبقة النقل (TLS)

GetOptionGroupsResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • مجموعات

    OptionGroup[] اختيارية

    إذا كانت قيمة الحقل result هي SUCCESS، سيتم تقديم قائمة بمجموعات الخيارات بالترتيب الذي يوفّره برنامج تشغيل الماسح الضوئي.

  • نتيجة

    OperationResult

    نتيجة الحصول على مجموعات الخيارات. إذا كانت قيمة هذه السمة SUCCESS، ستتم تعبئة السمة groups.

  • scannerHandle

    سلسلة

    مقبض الماسح الضوئي نفسه الذي تم تمريره إلى getOptionGroups.

GetScannerListResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • نتيجة

    OperationResult

    نتيجة التعداد تجدر الإشارة إلى أنّه يمكن عرض نتائج جزئية حتى إذا كان ذلك يشير إلى حدوث خطأ.

  • ماسحات ضوئية

    ScannerInfo[]

    قائمة يُحتمَل أن تكون فارغة من برامج الفحص التي تطابق رمز DeviceFilter المقدَّم.

OpenScannerResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • الخيارات

    الكائن اختياري

    إذا كانت قيمة السمة result هي SUCCESS، يتم تقديم ربط لقيمة المفتاح حيث يكون المفتاح خيارًا خاصًا بالجهاز وتكون القيمة مثيلاً لـ ScannerOption.

  • نتيجة

    OperationResult

    نتيجة فتح الماسح الضوئي. إذا كانت قيمة هذه السمة هي SUCCESS، ستتم تعبئة السمتَين scannerHandle وoptions.

  • scannerHandle

    سلسلة اختيارية

    إذا كانت قيمة السمة result هي SUCCESS، سيكون الاسم المعرِّف للماسح الضوئي يمكن استخدامه لإجراء المزيد من العمليات.

  • scannerId

    سلسلة

    تم تمرير رقم تعريف الماسح الضوئي إلى openScanner().

OperationResult

Chrome 125 والإصدارات الأحدث

تعداد يشير إلى نتيجة كل عملية.

التعداد

"UNKNOWN"
حدث خطأ غير معروف أو عام.

"Success"
نجحت العملية.

"غير مدعومة"
العملية غير متاحة.

"تم إلغاؤها"
تم إلغاء العملية.

"DEVICE_BUSY"
الجهاز مشغول.

"غير صالح"
البيانات أو الوسيطة التي تم تمريرها إلى الطريقة غير صالحة.

"WRONG_TYPE"
القيمة التي تم تقديمها هي نوع البيانات غير الصحيح للخيار الأساسي.

"EOF"
لا تتوفّر أيّ بيانات أخرى.

"ADF_JAMMED"
وحدة تغذية المستندات عالقة.

"ADF_EMPTY"
وحدة تغذية المستندات فارغة.

"COVER_OPEN"
الغطاء المسطَّح مفتوح.

"IO_ERROR"
حدث خطأ أثناء الاتصال بالجهاز.

"ACCESS_DENIED"
يجب مصادقة الجهاز.

"NO_MEMORY"
لا تتوفر ذاكرة كافية على جهاز Chromebook لإكمال العملية.

"غير قابلة للوصول"
لا يمكن الوصول إلى الجهاز.

"MightING"
الجهاز غير متصل.

"INTERNAL_ERROR"
حدث خطأ في مكان آخر غير تطبيق الاتصال.

OptionConstraint

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • قائمة

    string[]|number[] optional

  • الحد الأقصى

    الرقم اختياري

  • دقيقة

    الرقم اختياري

  • الكمّية

    الرقم اختياري

  • كتابة

    ConstraintType

OptionGroup

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • الأعضاء

    سلسلة[]

    مصفوفة من أسماء الخيارات بترتيب مقدَّمة من السائق.

  • title

    سلسلة

    توفّر عنوانًا قابلاً للطباعة، مثل "خيارات الهندسة".

OptionSetting

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • اسم

    سلسلة

    تشير إلى اسم الخيار المطلوب ضبطه.

  • كتابة

    OptionType

    تشير هذه السمة إلى نوع بيانات الخيار. يجب أن يتطابق نوع البيانات المطلوب مع نوع البيانات الفعلي للخيار الأساسي.

  • القيمة

    string|number|boolean|number[] optional

    يشير إلى القيمة المطلوب ضبطها. يمكنك ترك السياسة بدون ضبط لطلب ضبط الإعداد التلقائي للخيارات التي تم فيها تفعيل autoSettable. يجب أن يتطابق نوع البيانات المقدَّم للسمة value مع type.

OptionType

Chrome 125 والإصدارات الأحدث

نوع البيانات لأحد الخيارات.

التعداد

"UNKNOWN"
نوع بيانات الخيار غير معروف. سيتم إلغاء ضبط السمة value.

"BOOL"
ستكون السمة value واحدة من trueخطأ.

"INT"
عدد صحيح 32 بت مُوقَّع. ستكون السمة value طويلة أو طويلة[]، اعتمادًا على ما إذا كان الخيار سيتطلّب أكثر من قيمة واحدة.

"FIXED"
عدد مزدوج في النطاق -32768-32767.9999 وبدرجة دقة 1/65535. ستكون السمة value مزدوجة أو مزدوجة[] استنادًا إلى ما إذا كان الخيار سيتطلّب أكثر من قيمة واحدة. وسيتم تقريب القيم المزدوجة التي لا يمكن تمثيلها بدقة إلى النطاق والدقة المتاحَين.

"STRING"
تسلسل لأي بايت باستثناء القيمة الفارغة ('\0). ستكون السمة value هي DOMString.

"button"
لا يحتوي خيار من هذا النوع على قيمة. بدلاً من ذلك، يؤدي تحديد خيار من هذا النوع إلى حدوث تأثير جانبي خاص بالخيار في برنامج تشغيل الماسح الضوئي. على سبيل المثال، يمكن أن يستخدم برنامج تشغيل الماسح الضوئي خيارًا من نوع الأزرار لتحديد القيم التلقائية أو لتوجيه أداة تغذية المستندات التلقائية إلى الورقة التالية.

"GROUP"
خيار التجميع. بلا قيمة. ويتم تضمين هذه السمة من أجل التوافق، ولكن لن يتم عرضها عادةً في قيم ScannerOption. استخدِم getOptionGroups() لاسترداد قائمة المجموعات مع خيارات الأعضاء فيها.

OptionUnit

Chrome 125 والإصدارات الأحدث

يشير هذا الحقل إلى نوع بيانات ScannerOption.unit.

التعداد

"UNITLESS"
القيمة هي رقم بدون وحدة. على سبيل المثال، يمكن أن تكون قيمة ثابتة.

"PIXEL"
القيمة هي عدد من وحدات البكسل، على سبيل المثال، أبعاد المسح الضوئي.

"BIT"
القيمة هي عدد وحدات البت، مثل عمق اللون.

"MM"
يتم قياس القيمة بالملليمتر، مثل أبعاد المسح الضوئي.

"DPI"
يتم قياس القيمة بالنقاط لكل بوصة، على سبيل المثال، درجة الدقة.

"PERCENT"
القيمة هي نسبة مئوية، على سبيل المثال، السطوع.

"MICROSECOND"
يتم قياس القيمة بالميكرو ثانية، على سبيل المثال، وقت التعرّض.

ReadScanDataResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • البيانات

    ArrayBuffer اختيارية

    إذا كانت قيمة السمة result هي SUCCESS، يجب تضمين المقطع التالي من بيانات الصور الممسوحة ضوئيًا. إذا كانت قيمة السمة result هي EOF، يجب تضمين المقطع الأخير من بيانات الصور الممسوحة ضوئيًا.

  • estimatedCompletion

    الرقم اختياري

    إذا كانت قيمة result هي SUCCESS، سيكون تقدير مقدار إجمالي بيانات الفحص التي تم إرسالها حتى الآن، في النطاق من 0 إلى 100.

  • وظيفة

    سلسلة

    تقدِّم هذه السمة الاسم المعرِّف الوظيفي الذي تم تمريره إلى readScanData().

  • نتيجة

    OperationResult

    نتيجة قراءة البيانات. إذا كانت قيمتها SUCCESS، سيحتوي data على المقطع التالي (الذي قد يكون ذو طول صفري) من بيانات الصورة الجاهزة للقراءة. إذا كانت قيمتها EOF، سيحتوي data على المقطع الأخير من بيانات الصورة.

ScannerInfo

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • connectionType

    ConnectionType

    يشير إلى كيفية اتصال الماسح الضوئي بالكمبيوتر.

  • deviceUuid

    سلسلة

    للمطابقة مع إدخالات ScannerInfo الأخرى التي تشير إلى الجهاز الفعلي نفسه

  • imageFormats

    سلسلة[]

    مصفوفة من أنواع MIME التي يمكن طلبها لعمليات الفحص التي تم إرجاعها.

  • الشركة المصنّعة

    سلسلة

    الشركة المصنّعة للماسح الضوئي

  • model

    سلسلة

    طراز الماسح الضوئي في حال توفّره، أو وصف عام.

  • اسم

    سلسلة

    تمثّل هذه السمة اسم يمكن للماسح الضوئي قراءته في واجهة المستخدم.

  • protocolType

    سلسلة

    وصف يمكن لشخص عادي قراءته للبروتوكول أو برنامج التشغيل المستخدَم للوصول إلى برنامج الماسح الضوئي، مثل Mopria أو WSD أو epsonds. وهذا مفيد في المقام الأول للسماح للمستخدم بالاختيار من بين البروتوكولات إذا كان الجهاز يدعم بروتوكولات متعددة.

  • scannerId

    سلسلة

    رقم تعريف ماسح ضوئي معيّن.

  • آمن

    boolean

    في حال اختيار القيمة "صحيح"، لا يمكن أن يعترض جهاز مستمع سلبي، مثل بروتوكول أمان طبقة النقل (TLS) أو USB عملية نقل اتصال الماسح الضوئي.

ScannerOption

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • إمكانية الضبط

    إمكانية الضبط

    تشير إلى ما إذا كان يمكن تغيير الخيار وكيفية تغييره.

  • قيد

    OptionConstraint اختيارية

    لتحديد OptionConstraint في خيار الماسح الضوئي الحالي.

  • الوصف

    سلسلة

    وصف أطول للخيار.

  • isActive

    boolean

    تشير إلى أن الخيار نشط ويمكن ضبطه أو استرداده. وفي حال اختيار القيمة "خطأ"، لن يتم ضبط السمة value.

  • isAdvanced

    boolean

    تشير هذه السمة إلى أنّه يجب ألا تعرض واجهة المستخدم هذا الخيار تلقائيًا.

  • isAutoSettable

    boolean

    يمكن ضبطها تلقائيًا بواسطة برنامج تشغيل الماسح الضوئي.

  • isDetectable

    boolean

    تشير إلى إمكانية اكتشاف هذا الخيار من خلال البرنامج.

  • isEmulated

    boolean

    وتتم المحاكاة من خلال برنامج تشغيل الماسح الضوئي إذا كانت القيمة true.

  • اسم

    سلسلة

    اسم الخيار باستخدام أحرف ASCII صغيرة وأرقام وشرطات. لا يُسمح باستخدام علامات التشكيل.

  • title

    سلسلة

    عنوان مكون من سطر واحد قابل للطباعة.

  • كتابة

    OptionType

    تمثّل هذه السمة نوع البيانات المضمّنة في السمة value، وهي مطلوبة لضبط هذا الخيار.

  • الوحدة

    OptionUnit

    وحدة القياس لهذا الخيار.

  • القيمة

    string|number|boolean|number[] optional

    القيمة الحالية للخيار، إذا كان ذلك ملائمًا. لاحظ أن نوع البيانات لهذا الموقع يجب أن يتطابق مع نوع البيانات المحدّد في type.

ScanOptions

أماكن إقامة

  • maxImages

    الرقم اختياري

    عدد الصور الممسوحة ضوئيًا المسموح بها. القيمة التلقائية هي 1.

  • mimeTypes

    سلسلة[] اختيارية

    أنواع MIME التي يقبلها المتصل.

ScanResults

أماكن إقامة

  • dataUrls

    سلسلة[]

    مصفوفة من عناوين URL لصور البيانات في شكل يمكن تمريرها كقيمة "src" إلى علامة صورة

  • mimeType

    سلسلة

    تمثّل هذه السمة نوع MIME للسمة dataUrls.

SetOptionResult

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • اسم

    سلسلة

    يشير إلى اسم الخيار الذي تم ضبطه.

  • نتيجة

    OperationResult

    تشير هذه السمة إلى نتيجة ضبط الخيار.

SetOptionsResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • الخيارات

    الكائن اختياري

    تم تعديل ربط قيمة المفتاح من أسماء الخيارات إلى قيم ScannerOption التي تحتوي على الإعدادات الجديدة بعد محاولة ضبط جميع الخيارات المقدَّمة. لها نفس بنية السمة options في OpenScannerResponse.

    سيتم ضبط هذه السمة حتى إذا لم يتم ضبط بعض الخيارات بنجاح، ولكن سيتم تركها بدون ضبط في حال تعذّر استرداد الإعدادات المعدَّلة (على سبيل المثال، إذا كان الماسح الضوئي غير متصل في منتصف عملية الفحص).

  • النتائج

    SetOptionResult[]

    مصفوفة من النتائج، واحدة لكل OptionSetting تم تمريرها.

  • scannerHandle

    سلسلة

    توفِّر هذه السياسة مقبض الماسح الضوئي الذي تم تمريره إلى setOptions().

StartScanOptions

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • التنسيق

    سلسلة

    تُحدِّد نوع MIME الذي سيتم فيه عرض البيانات الممسوحة ضوئيًا.

  • maxReadSize

    الرقم اختياري

    في حال تحديد قيمة غير صفرية، يتم تقييد الحد الأقصى لوحدات البايت التي يتم فحصها في استجابة readScanData واحدة لتلك القيمة. علمًا بأن أصغر قيمة مسموح بها هي 32768 (32 كيلوبايت). إذا لم يتم تحديد هذه الخاصية، فقد يكون حجم المقطع المعروض بحجم الصورة الممسوحة ضوئيًا بالكامل.

StartScanResponse

Chrome 125 والإصدارات الأحدث

أماكن إقامة

  • وظيفة

    سلسلة اختيارية

    إذا كانت قيمة السمة result هي SUCCESS، يتم توفير اسم معرِّف يمكن استخدامه لقراءة بيانات البحث أو إلغاء المهمة.

  • نتيجة

    OperationResult

    نتيجة بدء الفحص. إذا كانت قيمة هذه السمة SUCCESS، ستتم تعبئة السمة job.

  • scannerHandle

    سلسلة

    يوفّر مقبض الماسح الضوئي نفسه الذي تم تمريره إلى startScan().

الطُرق

cancelScan()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.cancelScan(
  job: string,
  callback?: function,
)

لإلغاء الفحص الذي تم بدؤه وعرض وعد يتم حله مع عنصر CancelScanResponse. وفي حال استخدام معاودة الاتصال، يتم تمرير الكائن إليه بدلاً من ذلك.

المَعلمات

  • وظيفة

    سلسلة

    الاسم المعرِّف لمهمة فحص نشطة تم إرجاعها في السابق من مكالمة إلى startScan.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: CancelScanResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

closeScanner()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.closeScanner(
  scannerHandle: string,
  callback?: function,
)

يتم إغلاق الماسح الضوئي للمقبض الذي تم تمريره وعرض رمز الوعد الذي يتم حله مع عنصر CloseScannerResponse. وفي حال استخدام معاودة الاتصال، يتم تمرير الكائن إليه بدلاً من ذلك. وحتى إذا لم تكن الاستجابة ناجحة، يصبح الاسم المعرِّف المقدَّم غير صالح ويجب عدم استخدامه في عمليات إضافية.

المَعلمات

  • scannerHandle

    سلسلة

    تُحدِّد مقبض ماسح ضوئي مفتوح تم عرضه سابقًا من مكالمة إلى openScanner.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: CloseScannerResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getOptionGroups()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.getOptionGroups(
  scannerHandle: string,
  callback?: function,
)

للحصول على أسماء المجموعات وخيارات الأعضاء من ماسح ضوئي تم فتحه سابقًا من خلال openScanner. تعرِض هذه الطريقة وعدًا يتم حلّه باستخدام كائن GetOptionGroupsResponse. إذا تم تمرير معاودة الاتصال إلى هذه الدالة، يتم تمرير البيانات المعروضة إليها بدلاً من ذلك.

المَعلمات

  • scannerHandle

    سلسلة

    مقبض ماسح ضوئي مفتوح تم إرجاعه من مكالمة إلى openScanner.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: GetOptionGroupsResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getScannerList()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.getScannerList(
  filter: DeviceFilter,
  callback?: function,
)

للحصول على قائمة بالماسحات الضوئية المتاحة وعرض وعد يتم حله مع عنصر GetScannerListResponse. إذا تم تمرير معاودة الاتصال إلى هذه الدالة، يتم تمرير البيانات المعروضة إليها بدلاً من ذلك.

المَعلمات

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

openScanner()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.openScanner(
  scannerId: string,
  callback?: function,
)

يؤدي هذا الاختصار إلى فتح ماسح ضوئي لإتاحة الوصول الحصري وعرض وعد يتم حله مع عنصر OpenScannerResponse. إذا تم تمرير معاودة الاتصال إلى هذه الدالة، يتم تمرير البيانات المعروضة إليها بدلاً من ذلك.

المَعلمات

  • scannerId

    سلسلة

    رقم تعريف الماسح الضوئي المُراد فتحه. هذه القيمة هي قيمة تم عرضها من مكالمة سابقة إلى getScannerList.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: OpenScannerResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

readScanData()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.readScanData(
  job: string,
  callback?: function,
)

تقرأ المقطع التالي من بيانات الصورة المتاحة من مؤشر مهمة نشط، وتعرض Promise الذي يتم حله باستخدام كائن ReadScanDataResponse. وفي حال استخدام معاودة الاتصال، يتم تمرير الكائن إليه بدلاً من ذلك.

**ملاحظة:**يمكن أن تكون نتيجة الرد SUCCESS مع تضمين عضو في data بقيمة صفرية. وهذا يعني أنّ الماسح الضوئي لا يزال يعمل ولكن ليس لديه بيانات إضافية جاهزة حتى الآن. يجب أن ينتظر المتصل وقتًا قصيرًا ويعيد المحاولة.

عند اكتمال مهمة البحث، ستكون قيمة النتيجة EOF للاستجابة. قد تحتوي هذه الإجابة على عضو نهائي في "data" بقيمة غير صفرية.

المَعلمات

  • وظيفة

    سلسلة

    الاسم المعرِّف للمهمة النشط الذي تم عرضه سابقًا من startScan.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: ReadScanDataResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

scan()

وعد 
chrome.documentScan.scan(
  options: ScanOptions,
  callback?: function,
)

يُجري مسحًا ضوئيًا للمستندات ويعرض وعدًا يتم حلّه مع عنصر ScanResults. إذا تم تمرير معاودة الاتصال إلى هذه الدالة، يتم تمرير البيانات التي يتم عرضها إليها بدلاً من ذلك.

المَعلمات

  • الخيارات

    ScanOptions

    عنصر يحتوي على معلَمات فحص

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (result: ScanResults)=>void

المرتجعات

  • Promise<ScanResults>

    Chrome 96 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

setOptions()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.setOptions(
  scannerHandle: string,
  options: OptionSetting[],
  callback?: function,
)

لضبط الخيارات على الماسح الضوئي المحدّد، وعرض وعد يتم حله مع عنصر SetOptionsResponse يحتوي على نتيجة محاولة ضبط كل قيمة بترتيب العنصر OptionSetting الذي تم تمريره. وفي حال استخدام معاودة الاتصال، يتم تمرير الكائن إليه بدلاً من ذلك.

المَعلمات

  • scannerHandle

    سلسلة

    مقبض الماسح الضوئي لضبط الخيارات عليه. يجب أن تكون هذه قيمة تم عرضها في السابق من مكالمة إلى openScanner.

  • الخيارات

    OptionSetting[]

    تضم هذه القائمة OptionSetting عناصر سيتم تطبيقها على الماسح الضوئي.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: SetOptionsResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

startScan()

الوعد Chrome 125 والإصدارات الأحدث 
chrome.documentScan.startScan(
  scannerHandle: string,
  options: StartScanOptions,
  callback?: function,
)

تبدأ عملية فحص على الماسح الضوئي المحدّد وعرض وعد يفي بـ StartScanResponse. وفي حال استخدام معاودة الاتصال، يتم تمرير الكائن إليه بدلاً من ذلك. إذا تمت المكالمة بنجاح، سيتضمن الرد الاسم المعرِّف للوظيفة الذي يمكن استخدامه في الطلبات اللاحقة لقراءة بيانات البحث أو إلغاء الفحص.

المَعلمات

  • scannerHandle

    سلسلة

    مقبض الماسح الضوئي المفتوح. يجب أن تكون هذه قيمة تم عرضها في السابق من مكالمة إلى openScanner.

  • الخيارات

    StartScanOptions

    عنصر StartScanOptions يشير إلى الخيارات التي سيتم استخدامها في الفحص يجب أن تتطابق السمة StartScanOptions.format مع أحد الإدخالات المعروضة في سمة ScannerInfo الخاصة بالماسح الضوئي.

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (response: StartScanResponse)=>void

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.