chrome.management

الوصف

توفّر واجهة برمجة التطبيقات chrome.management API طرقًا لإدارة قائمة الإضافات أو التطبيقات التي يتم تثبيتها وتشغيلها. وهو مفيد بشكل خاص للإضافات التي تتجاهل صفحة "علامة تبويب جديدة" المضمّنة.

الأذونات

management

يجب تعريف إذن "الإدارة" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات للإدارة. مثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "management"
  ],
  ...
}

لا تتطلّب management.getPermissionWarningsByManifest() وmanagement.uninstallSelf() وmanagement.getSelf() الحصول على إذن بالإدارة.

الأنواع

ExtensionDisabledReason

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

سبب إيقاف العنصر

التعداد

ExtensionInfo

معلومات عن إضافة أو تطبيق أو مظهر مثبَّت

أماكن إقامة

• appLaunchUrl

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

  عنوان URL لبدء التشغيل (متاح للتطبيقات فقط).

• availableLaunchTypes

  LaunchType[] اختيارية

  أنواع عمليات الإطلاق المتوفّرة حاليًا (تتوفّر فقط للتطبيقات).

• الوصف

  سلسلة

  وصف هذه الإضافة أو التطبيق أو المظهر.

• disabledReason

  ExtensionDisabledReason اختيارية

  سبب إيقاف العنصر

• مفعّلة

  boolean

  ما إذا كانت الميزة مفعَّلة أو غير مفعَّلة حاليًا

• homepageUrl

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

  عنوان URL للصفحة الرئيسية لهذه الإضافة أو التطبيق أو المظهر.

• hostPermissions

  سلسلة[]

  عرض قائمة بالأذونات المستندة إلى المضيف.

• الأيقونات

  IconInfo[] اختيارية

  تمثّل هذه السمة قائمة بمعلومات الرمز. يُرجى العِلم أنّ هذا الإجراء يعكس فقط ما تم تعريفه في ملف البيان، وأنّ الصورة الفعلية على عنوان URL هذا قد تكون أكبر أو أصغر من ما تم تعريفه، لذا يمكنك استخدام سمات واضحة للعرض والارتفاع على علامات img التي تشير إلى هذه الصور. يمكنك الاطّلاع على مستندات البيان حول الرموز للحصول على مزيد من التفاصيل.

• id

  سلسلة

  المعرّف الفريد للإضافة

• installType

  ExtensionInstallType

  طريقة تثبيت الإضافة

• isApp

  boolean

  متوقّف نهائيًا

  يُرجى استخدام management.ExtensionInfo.type.

  True إذا كان هذا تطبيقًا.

• launchType

  LaunchType اختيارية

  نوع تشغيل التطبيق (متاح للتطبيقات فقط).

• mayDisable

  boolean

  تحدد هذه القيمة ما إذا كان بإمكان المستخدم إيقاف هذه الإضافة أو إلغاء تثبيتها.

• mayEnable

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

  الإصدار 62 من Chrome والإصدارات الأحدث

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

• اسم

  سلسلة

  اسم هذه الإضافة أو التطبيق أو المظهر.

• offlineEnabled

  boolean

  ما إذا كانت الإضافة أو التطبيق أو المظهر يُعلمان بأنّهما يتوافقان مع وضع عدم الاتصال بالإنترنت

• optionsUrl

  سلسلة

  عنوان URL لصفحة خيارات العنصر، إذا كانت تحتوي على عنوان.

• الأذونات

  سلسلة[]

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

• shortName

  سلسلة

  نسخة قصيرة من اسم هذه الإضافة أو التطبيق أو المظهر

• كتابة

  ExtensionType

  نوع هذه الإضافة أو التطبيق أو المظهر.

• updateUrl

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

  عنوان URL للتحديث لهذه الإضافة أو التطبيق أو المظهر.

• إصدار

  سلسلة

  إصدار هذه الإضافة أو التطبيق أو المظهر

• versionName

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

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

  اسم إصدار هذه الإضافة أو التطبيق أو المظهر إذا كان البيان قد حدّد أيًا منها.

ExtensionInstallType

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

طريقة تثبيت الإضافة أحد admin: تم تثبيت الإضافة بسبب سياسة إدارية، development: تم تحميل الإضافة بدون ضغط في وضع مطوّر البرامج، normal: تم تثبيت الإضافة بشكل طبيعي من خلال ملف .crx، sideload: تم تثبيت الإضافة بواسطة برنامج آخر على الجهاز، other: تم تثبيت الإضافة بطرق أخرى.

التعداد

ExtensionType

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

نوع هذه الإضافة أو التطبيق أو المظهر.

التعداد

"packaged_app"

"login_screen_extension"

IconInfo

معلومات حول رمز ينتمي إلى إضافة أو تطبيق أو مظهر.

أماكن إقامة

• الحجم

  الرقم

  رقم يمثل عرض الرمز وارتفاعه. تشمل القيم المحتملة (على سبيل المثال لا الحصر) 128 و48 و24 و16.

• url

  سلسلة

  عنوان URL لصورة الرمز هذه. لعرض نسخة ذات تدرّج الرمادي من الرمز (للإشارة إلى أنّ إحدى الإضافات غير مفعّلة، على سبيل المثال)، ألحِق ?grayscale=true بعنوان URL.

LaunchType

هذه هي جميع أنواع تشغيل التطبيقات الممكنة.

التعداد

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

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

خيارات كيفية التعامل مع إلغاء تثبيت الإضافة

أماكن إقامة

• showConfirmDialog

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

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

الطُرق

createAppShortcut()

وعد

chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

عرض خيارات إنشاء اختصارات لتطبيق ما. في نظام التشغيل Mac، يمكن إنشاء اختصارات التطبيقات المجمّعة فقط.

المَعلمات

• id

  سلسلة

  يجب أن يكون هذا المعرّف من عنصر تطبيق management.ExtensionInfo.

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

generateAppForLink()

وعد

chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

أنشِئ تطبيقًا لعنوان URL. لعرض تطبيق الإشارات المرجعية الذي تم إنشاؤه

المَعلمات

• url

  سلسلة

  تمثّل هذه السمة عنوان URL لصفحة ويب. يجب أن يكون مخطط عنوان URL مجرّد "http" أو "https" فقط.

• title

  سلسلة

  عنوان التطبيق الذي تم إنشاؤه

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

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

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

  (result: ExtensionInfo)=>void

  • نتيجة

    ExtensionInfo

المرتجعات

• Promise<ExtensionInfo>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

get()

وعد

chrome.management.get(
  id: string,
  callback?: function,
)

عرض معلومات عن الإضافة أو التطبيق أو المظهر المُثبَّت الذي يحتوي على رقم التعريف المحدّد.

المَعلمات

• id

  سلسلة

  المعرّف الوارد من عنصر management.ExtensionInfo.

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

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

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

  (result: ExtensionInfo)=>void

  • نتيجة

    ExtensionInfo

المرتجعات

• Promise<ExtensionInfo>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

getAll()

وعد

chrome.management.getAll(
  callback?: function,
)

عرض قائمة بمعلومات حول الإضافات والتطبيقات المثبّتة

المَعلمات

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

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

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

  (result: ExtensionInfo[])=>void

  • نتيجة

    ExtensionInfo[]

المرتجعات

• Promise<ExtensionInfo[]>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

getPermissionWarningsById()

وعد

chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

تعرض قائمة تحذيرات بشأن الأذونات لمعرّف الإضافة المحدّد.

المَعلمات

• id

  سلسلة

  رقم تعريف إضافة مثبَّتة سابقًا

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

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

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

  (permissionWarnings: string[])=>void

  • permissionWarnings

    سلسلة[]

المرتجعات

• وعد<string[]>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

getPermissionWarningsByManifest()

وعد

chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

تعرض قائمة تحذيرات بشأن الأذونات لسلسلة بيان الإضافة المحدّدة. ملاحظة: يمكن استخدام هذه الدالة بدون طلب إذن "الإدارة" في البيان.

المَعلمات

• manifestStr

  سلسلة

  سلسلة JSON لبيان الإضافة

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

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

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

  (permissionWarnings: string[])=>void

  • permissionWarnings

    سلسلة[]

المرتجعات

• وعد<string[]>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

getSelf()

وعد

chrome.management.getSelf(
  callback?: function,
)

عرض معلومات عن إضافة الاتصال أو التطبيق أو المظهر ملاحظة: يمكن استخدام هذه الدالة بدون طلب إذن "الإدارة" في البيان.

المَعلمات

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

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

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

  (result: ExtensionInfo)=>void

  • نتيجة

    ExtensionInfo

المرتجعات

• Promise<ExtensionInfo>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

installReplacementWebApp()

البيانات المضمونة Chrome 77 والإصدارات الأحدث

chrome.management.installReplacementWebApp(
  callback?: function,
)

لتشغيل alternate_web_app المحدّد في ملف البيان. تطلب من المستخدم التثبيت إذا لم يكن مثبّتًا.

المَعلمات

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

launchApp()

وعد

chrome.management.launchApp(
  id: string,
  callback?: function,
)

تشغيل تطبيق.

المَعلمات

• id

  سلسلة

  معرّف الإضافة للتطبيق.

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

setEnabled()

وعد

chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
)

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

المَعلمات

• id

  سلسلة

  يجب أن يكون هذا المعرّف من عنصر management.ExtensionInfo.

• مفعّلة

  boolean

  ما إذا كان يجب تفعيل هذا العنصر أو إيقافه.

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

setLaunchType()

وعد

chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

حدِّد نوع تشغيل التطبيق.

المَعلمات

• id

  سلسلة

  يجب أن يكون هذا المعرّف من عنصر تطبيق management.ExtensionInfo.

• launchType

  LaunchType

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

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

uninstall()

وعد

chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

لإلغاء تثبيت تطبيق أو إضافة مثبَّتة حاليًا. ملاحظة: لا تعمل هذه الوظيفة في البيئات المُدارة عندما لا يُسمح للمستخدم بإلغاء تثبيت الإضافة أو التطبيق المحدّد. في حال تعذُّر إلغاء التثبيت (مثلاً، ألغى المستخدم مربّع الحوار)، سيتم رفض الوعد أو سيتم طلب معاودة الاتصال مع ضبط runtime.lastError.

المَعلمات

• id

  سلسلة

  يجب أن يكون هذا المعرّف من عنصر management.ExtensionInfo.

• الخيارات

  UninstallOptions اختيارية

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

uninstallSelf()

وعد

chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

يتم إلغاء تثبيت إضافة الاتصال. ملاحظة: يمكن استخدام هذه الدالة بدون طلب إذن "الإدارة" في البيان. لا تعمل هذه الدالة في البيئات المُدارة عندما لا يُسمح للمستخدم بإلغاء تثبيت الإضافة/التطبيق المحدّد.

المَعلمات

• الخيارات

  UninstallOptions اختيارية

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

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

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

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

فعاليات

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

يتم تنشيطها عند إيقاف تطبيق أو إضافة.

المَعلمات

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

  الوظيفة

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

  (info: ExtensionInfo)=>void

  • معلومات

    ExtensionInfo

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

يتم تنشيطها عند تفعيل تطبيق أو إضافة.

المَعلمات

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

  الوظيفة

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

  (info: ExtensionInfo)=>void

  • معلومات

    ExtensionInfo

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

يتم تنشيطها عند تثبيت تطبيق أو إضافة.

المَعلمات

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

  الوظيفة

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

  (info: ExtensionInfo)=>void

  • معلومات

    ExtensionInfo

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

يتم تنشيطها عند إلغاء تثبيت تطبيق أو إضافة.

المَعلمات

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

  الوظيفة

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

  (id: string)=>void

  • id

    سلسلة