chrome.management

الوصف

توفّر واجهة برمجة التطبيقات chrome.management طرقًا لإدارة التطبيقات والإضافات المثبَّتة.

الأذونات

management

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

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

management.getPermissionWarningsByManifest() وmanagement.uninstallSelf() و لا يتطلب management.getSelf() إذن الإدارة.

الأنواع

ExtensionDisabledReason

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

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

Enum

"غير معروف"

"permissions_increase"

ExtensionInfo

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

أماكن إقامة

  • appLaunchUrl

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

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

  • availableLaunchTypes

    LaunchType[] اختيارية

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

  • الوصف

    سلسلة

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

  • disabledReason

    ExtensionDisabledReason اختياري

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

  • مفعّلة

    منطقي

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

  • homepageUrl

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

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

  • hostPermissions

    سلسلة[]

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

  • رموز

    IconInfo[] اختيارية

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

  • id

    سلسلة

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

  • installType

    ExtensionInstallType

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

  • isApp

    منطقي

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

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

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

  • launchType

    LaunchType اختياري

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

  • mayDisable

    منطقي

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

  • mayEnable

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

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

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

  • الاسم

    سلسلة

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

  • offlineEnabled

    منطقي

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

  • optionsUrl

    سلسلة

    تمثّل هذه السمة عنوان URL لصفحة خيارات العنصر، إذا كانت متوفّرة.

  • الأذون

    سلسلة[]

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

  • الاسم المختصر

    سلسلة

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

  • كتابة

    ExtensionType

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

  • updateUrl

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

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

  • إصدار

    سلسلة

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

  • versionName

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

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

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

ExtensionInstallType

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

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

Enum

"مشرف"

"التطوير"

"عادي"

"التثبيت من مصدر غير معروف"

"other"

ExtensionType

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

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

Enum

"الإضافة"

"host_app"

"packaged_app"

"legacy_packaged_app"

"المظهر"

"login_screen_extension"

IconInfo

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

أماكن إقامة

  • الحجم

    الرقم

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

  • url

    سلسلة

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

LaunchType

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

Enum

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

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

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

أماكن إقامة

  • showConfirmDialog

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

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

الطُرق

createAppShortcut()

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

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

المعلمات

  • id

    سلسلة

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

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

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

المعلمات

  • url

    سلسلة

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

  • title

    سلسلة

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (result: ExtensionInfo) => void

المرتجعات

  • Promise&lt;ExtensionInfo&gt;

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

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

get()

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

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

المعلمات

المرتجعات

  • Promise&lt;ExtensionInfo&gt;

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

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

getAll()

وعود 
chrome.management.getAll(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (result: ExtensionInfo[]) => void

المرتجعات

  • Promise&lt;ExtensionInfo[]&gt;

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

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

getPermissionWarningsById()

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

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

المعلمات

  • id

    سلسلة

    رقم تعريف إضافة مثبَّتة من قبل.

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      سلسلة[]

المرتجعات

  • Promise&lt;string[]&gt;

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

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

getPermissionWarningsByManifest()

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

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

المعلمات

  • manifestStr

    سلسلة

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      سلسلة[]

المرتجعات

  • Promise&lt;string[]&gt;

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

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

getSelf()

وعود 
chrome.management.getSelf(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (result: ExtensionInfo) => void

المرتجعات

  • Promise&lt;ExtensionInfo&gt;

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

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

installReplacementWebApp()

وعود الإصدار 77 من Chrome أو الإصدارات الأحدث 
chrome.management.installReplacementWebApp(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

launchApp()

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

لتشغيل تطبيق.

المعلمات

  • id

    سلسلة

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

setEnabled()

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

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

المعلمات

  • id

    سلسلة

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

  • مفعّلة

    منطقي

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

setLaunchType()

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

يمكنك تحديد نوع تشغيل التطبيق.

المعلمات

  • id

    سلسلة

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

  • launchType

    LaunchType

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

uninstall()

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

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

المعلمات

  • id

    سلسلة

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

  • الخيارات

    UninstallOptions اختياري

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

uninstallSelf()

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

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

المعلمات

  • الخيارات

    UninstallOptions اختياري

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

فعاليات

onDisabled

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: ExtensionInfo) => void

onEnabled

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: ExtensionInfo) => void

onInstalled

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: ExtensionInfo) => void

onUninstalled

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (id: string) => void

    • id

      سلسلة