chrome.management

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

management

البيان

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

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

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

الأنواع

ExtensionDisabledReason

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

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

Enum

"unknown"

‫"permissions_increase"

ExtensionInfo

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

الخصائص

• appLaunchUrl

  string اختياري

  عنوان URL الخاص بالتشغيل (يتوفّر للتطبيقات فقط)

• availableLaunchTypes

  LaunchType[] اختياري

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

• الوصف

  سلسلة

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

• disabledReason

  ExtensionDisabledReason اختياري

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

• مفعّلة

  قيمة منطقية

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

• homepageUrl

  string اختياري

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

• hostPermissions

  string[]

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

• رموز

  IconInfo[] اختيارية

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

• id

  سلسلة

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

• installType

  ExtensionInstallType

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

• isApp

  قيمة منطقية

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

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

  تكون القيمة "صحيح" إذا كان هذا تطبيقًا.

• launchType

  LaunchType اختياري

  نوع تشغيل التطبيق (لا يظهر إلا للتطبيقات)

• mayDisable

  قيمة منطقية

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

• mayEnable

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

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

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

• الاسم

  سلسلة

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

• offlineEnabled

  قيمة منطقية

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

• optionsUrl

  سلسلة

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

• أذونات

  string[]

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

• shortName

  سلسلة

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

• النوع

  ExtensionType

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

• updateUrl

  string اختياري

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

• الإصدار

  سلسلة

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

• versionName

  string اختياري

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

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

ExtensionInstallType

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

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

Enum

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

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

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

Enum

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"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()

Promise

chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

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

المعلمات

• id

  سلسلة

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

generateAppForLink()

Promise

chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

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

المعلمات

• url

  سلسلة

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

• title

  سلسلة

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

• callback

  function اختياري

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

  (result: ExtensionInfo) => void

  • نتيجة

    ExtensionInfo

المرتجعات

• Promise<ExtensionInfo>

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

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

get()

Promise

chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

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

المعلمات

• id

  سلسلة

  رقم التعريف من عنصر في management.ExtensionInfo.

• callback

  function اختياري

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

  (result: ExtensionInfo) => void

  • نتيجة

    ExtensionInfo

المرتجعات

• Promise<ExtensionInfo>

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

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

getAll()

Promise

chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

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

المعلمات

• callback

  function اختياري

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

  (result: ExtensionInfo[]) => void

  • نتيجة

    ExtensionInfo[]

المرتجعات

• Promise<ExtensionInfo[]>

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

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

getPermissionWarningsById()

Promise

chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

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

المعلمات

• id

  سلسلة

  رقم تعريف إضافة سبق تثبيتها

• callback

  function اختياري

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

  (permissionWarnings: string[]) => void

  • permissionWarnings

    string[]

المرتجعات

• وعد<سلسلة نصية[]>

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

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

getPermissionWarningsByManifest()

Promise

chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

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

المعلمات

• manifestStr

  سلسلة

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

• callback

  function اختياري

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

  (permissionWarnings: string[]) => void

  • permissionWarnings

    string[]

المرتجعات

• وعد<سلسلة نصية[]>

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

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

getSelf()

Promise

chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

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

المعلمات

• callback

  function اختياري

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

  (result: ExtensionInfo) => void

  • نتيجة

    ExtensionInfo

المرتجعات

• Promise<ExtensionInfo>

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

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

installReplacementWebApp()

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

chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

يؤدي هذا الإجراء إلى تشغيل replacement_web_app المحدّد في البيان. يطلب من المستخدم تثبيت التطبيق إذا لم يكن مثبّتًا.

المعلمات

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

launchApp()

Promise

chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

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

المعلمات

• id

  سلسلة

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

setEnabled()

Promise

chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

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

المعلمات

• id

  سلسلة

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

• مفعّلة

  قيمة منطقية

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

setLaunchType()

Promise

chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

ضبط نوع تشغيل التطبيق

المعلمات

• id

  سلسلة

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

• launchType

  LaunchType

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

uninstall()

Promise

chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

المعلمات

• id

  سلسلة

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

• الخيارات

  ‫UninstallOptions اختياري

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

uninstallSelf()

Promise

chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

المعلمات

• الخيارات

  ‫UninstallOptions اختياري

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

الفعاليات

onDisabled

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

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

المعلمات

• callback

  دالة

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

  (info: ExtensionInfo) => void

  • معلومات

    ExtensionInfo

onEnabled

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

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

المعلمات

• callback

  دالة

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

  (info: ExtensionInfo) => void

  • معلومات

    ExtensionInfo

onInstalled

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

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

المعلمات

• callback

  دالة

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

  (info: ExtensionInfo) => void

  • معلومات

    ExtensionInfo

onUninstalled

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

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

المعلمات

• callback

  دالة

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

  (id: string) => void

  • id

    سلسلة