الوصف
توفّر واجهة برمجة التطبيقات chrome.management
API طرقًا لإدارة قائمة الإضافات أو التطبيقات التي يتم تثبيتها وتشغيلها. وهو مفيد بشكل خاص للإضافات التي تتجاهل صفحة "علامة تبويب جديدة" المضمّنة.
الأذونات
management
البيان
يجب تعريف إذن "الإدارة" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات للإدارة. مثال:
{
"name": "My extension",
...
"permissions": [
"management"
],
...
}
لا تتطلّب management.getPermissionWarningsByManifest
وmanagement.uninstallSelf
وmanagement.getSelf
الحصول على إذن بالإدارة.
الأنواع
ExtensionDisabledReason
سبب إيقاف العنصر
التعداد
ExtensionInfo
معلومات عن إضافة أو تطبيق أو مظهر مثبَّت
أماكن إقامة
-
appLaunchUrl
سلسلة اختيارية
عنوان URL لبدء التشغيل (متاح للتطبيقات فقط).
-
availableLaunchTypes
LaunchType[] اختيارية
أنواع عمليات الإطلاق المتوفّرة حاليًا (تتوفّر فقط للتطبيقات).
-
الوصف
سلسلة
وصف هذه الإضافة أو التطبيق أو المظهر.
-
disabledReason
ExtensionDisabledReason اختيارية
سبب إيقاف العنصر
-
مفعّلة
boolean
ما إذا كانت الميزة مفعَّلة أو غير مفعَّلة حاليًا
-
homepageUrl
سلسلة اختيارية
عنوان URL للصفحة الرئيسية لهذه الإضافة أو التطبيق أو المظهر.
-
hostPermissions
سلسلة[]
عرض قائمة بالأذونات المستندة إلى المضيف.
-
الأيقونات
IconInfo[] اختيارية
تمثّل هذه السمة قائمة بمعلومات الرمز. يُرجى العِلم أنّ هذا الإجراء يعكس فقط ما تم تعريفه في ملف البيان، وأنّ الصورة الفعلية على عنوان URL هذا قد تكون أكبر أو أصغر من ما تم تعريفه، لذا يمكنك استخدام سمات واضحة للعرض والارتفاع على علامات img التي تشير إلى هذه الصور. يمكنك الاطّلاع على مستندات البيان حول الرموز للحصول على مزيد من التفاصيل.
-
id
سلسلة
المعرّف الفريد للإضافة
-
installType
طريقة تثبيت الإضافة
-
isApp
boolean
متوقّف نهائيًايُرجى استخدام
management.ExtensionInfo.type
.True إذا كان هذا تطبيقًا.
-
launchType
LaunchType اختيارية
نوع تشغيل التطبيق (متاح للتطبيقات فقط).
-
mayDisable
boolean
تحدد هذه القيمة ما إذا كان بإمكان المستخدم إيقاف هذه الإضافة أو إلغاء تثبيتها.
-
mayEnable
منطقية اختيارية
الإصدار 62 من Chrome والإصدارات الأحدثتحدد هذه القيمة ما إذا كان بإمكان المستخدم تفعيل هذه الإضافة. ولا يتم إرجاع هذه العملية إلا للإضافات غير المفعّلة.
-
اسم
سلسلة
اسم هذه الإضافة أو التطبيق أو المظهر.
-
offlineEnabled
boolean
ما إذا كانت الإضافة أو التطبيق أو المظهر يُعلمان بأنّهما يتوافقان مع وضع عدم الاتصال بالإنترنت
-
optionsUrl
سلسلة
عنوان URL لصفحة خيارات العنصر، إذا كانت تحتوي على عنوان.
-
الأذونات
سلسلة[]
تعرض قائمة بالأذونات المستندة إلى واجهة برمجة التطبيقات.
-
shortName
سلسلة
نسخة قصيرة من اسم هذه الإضافة أو التطبيق أو المظهر
-
كتابة
نوع هذه الإضافة أو التطبيق أو المظهر.
-
updateUrl
سلسلة اختيارية
عنوان URL للتحديث لهذه الإضافة أو التطبيق أو المظهر.
-
إصدار
سلسلة
إصدار هذه الإضافة أو التطبيق أو المظهر
-
versionName
سلسلة اختيارية
Chrome 50 والإصدارات الأحدثاسم إصدار هذه الإضافة أو التطبيق أو المظهر إذا كان البيان قد حدّد أيًا منها.
ExtensionInstallType
طريقة تثبيت الإضافة أحد
admin
: تم تثبيت الإضافة بسبب سياسة إدارية،
development
: تم تحميل الإضافة بدون ضغط في وضع مطوّر البرامج،
normal
: تم تثبيت الإضافة بشكل طبيعي من خلال ملف .crx،
sideload
: تم تثبيت الإضافة بواسطة برنامج آخر على الجهاز،
other
: تم تثبيت الإضافة بطرق أخرى.
التعداد
ExtensionType
نوع هذه الإضافة أو التطبيق أو المظهر.
التعداد
"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
خيارات كيفية التعامل مع إلغاء تثبيت الإضافة
أماكن إقامة
-
showConfirmDialog
منطقية اختيارية
تحديد ما إذا كان مربّع حوار تأكيد إلغاء التثبيت سيظهر للمستخدم طلبه أم لا يتم ضبط السياسة تلقائيًا على "خطأ" لعمليات إلغاء التثبيت الذاتية. إذا ألغت إحدى الإضافات إضافة أخرى، يتم تجاهل هذه المعلَمة ويتم عرض مربّع الحوار دائمًا.
الطُرق
createAppShortcut()
chrome.management.createAppShortcut(
id: string,
callback?: function,
)
عرض خيارات إنشاء اختصارات لتطبيق ما. في نظام التشغيل Mac، يمكن إنشاء اختصارات التطبيقات المجمّعة فقط.
المَعلمات
-
id
سلسلة
يجب أن يكون هذا المعرّف من عنصر تطبيق
management.ExtensionInfo
. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
generateAppForLink()
chrome.management.generateAppForLink(
url: string,
title: string,
callback?: function,
)
أنشِئ تطبيقًا لعنوان URL. لعرض تطبيق الإشارات المرجعية الذي تم إنشاؤه
المَعلمات
-
url
سلسلة
تمثّل هذه السمة عنوان URL لصفحة ويب. يجب أن يكون مخطط عنوان URL مجرّد "http" أو "https" فقط.
-
title
سلسلة
عنوان التطبيق الذي تم إنشاؤه
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: ExtensionInfo) => void
-
نتيجة
-
المرتجعات
-
Promise<ExtensionInfo>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
get()
chrome.management.get(
id: string,
callback?: function,
)
عرض معلومات عن الإضافة أو التطبيق أو المظهر المُثبَّت الذي يحتوي على رقم التعريف المحدّد.
المَعلمات
-
id
سلسلة
المعرّف الوارد من عنصر
management.ExtensionInfo
. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: ExtensionInfo) => void
-
نتيجة
-
المرتجعات
-
Promise<ExtensionInfo>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getAll()
chrome.management.getAll(
callback?: function,
)
عرض قائمة بمعلومات حول الإضافات والتطبيقات المثبّتة
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: ExtensionInfo[]) => void
-
نتيجة
-
المرتجعات
-
Promise<ExtensionInfo[]>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getPermissionWarningsById()
chrome.management.getPermissionWarningsById(
id: string,
callback?: function,
)
تعرض قائمة تحذيرات بشأن الأذونات لمعرّف الإضافة المحدّد.
المَعلمات
-
id
سلسلة
رقم تعريف إضافة مثبَّتة سابقًا
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(permissionWarnings: string[]) => void
-
permissionWarnings
سلسلة[]
-
المرتجعات
-
وعد<string[]>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getPermissionWarningsByManifest()
chrome.management.getPermissionWarningsByManifest(
manifestStr: string,
callback?: function,
)
تعرض قائمة تحذيرات بشأن الأذونات لسلسلة بيان الإضافة المحدّدة. ملاحظة: يمكن استخدام هذه الدالة بدون طلب إذن "الإدارة" في البيان.
المَعلمات
-
manifestStr
سلسلة
سلسلة JSON لبيان الإضافة
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(permissionWarnings: string[]) => void
-
permissionWarnings
سلسلة[]
-
المرتجعات
-
وعد<string[]>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getSelf()
chrome.management.getSelf(
callback?: function,
)
عرض معلومات عن إضافة الاتصال أو التطبيق أو المظهر ملاحظة: يمكن استخدام هذه الدالة بدون طلب إذن "الإدارة" في البيان.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: ExtensionInfo) => void
-
نتيجة
-
المرتجعات
-
Promise<ExtensionInfo>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
installReplacementWebApp()
chrome.management.installReplacementWebApp(
callback?: function,
)
لتشغيل alternate_web_app المحدّد في ملف البيان. تطلب من المستخدم التثبيت إذا لم يكن مثبّتًا.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
launchApp()
chrome.management.launchApp(
id: string,
callback?: function,
)
تشغيل تطبيق.
المَعلمات
-
id
سلسلة
معرّف الإضافة للتطبيق.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
setEnabled()
chrome.management.setEnabled(
id: string,
enabled: boolean,
callback?: function,
)
تفعيل تطبيق أو إضافة أو إيقافهما. في معظم الحالات، يجب استدعاء هذه الوظيفة في سياق إيماءة المستخدم (على سبيل المثال، معالِج النقر على أحد الأزرار)، وقد تقدّم للمستخدِم واجهة مستخدم تأكيد أصلية كطريقة لمنع إساءة الاستخدام.
المَعلمات
-
id
سلسلة
يجب أن يكون هذا المعرّف من عنصر
management.ExtensionInfo
. -
مفعّلة
boolean
ما إذا كان يجب تفعيل هذا العنصر أو إيقافه.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
setLaunchType()
chrome.management.setLaunchType(
id: string,
launchType: LaunchType,
callback?: function,
)
حدِّد نوع تشغيل التطبيق.
المَعلمات
-
id
سلسلة
يجب أن يكون هذا المعرّف من عنصر تطبيق
management.ExtensionInfo
. -
launchType
نوع الإطلاق المستهدَف تأكَّد دائمًا من أنّ نوع الإطلاق هذا مدرَج في
ExtensionInfo.availableLaunchTypes
، لأنّ أنواع الإطلاق المتاحة تختلف باختلاف الأنظمة الأساسية والإعدادات. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
uninstall()
chrome.management.uninstall(
id: string,
options?: UninstallOptions,
callback?: function,
)
لإلغاء تثبيت تطبيق أو إضافة مثبَّتة حاليًا. ملاحظة: لا تعمل هذه الوظيفة في البيئات المُدارة عندما لا يُسمح للمستخدم بإلغاء تثبيت الإضافة أو التطبيق المحدّد. في حال تعذُّر إلغاء التثبيت (مثلاً، ألغى المستخدم مربّع الحوار)، سيتم رفض الوعد أو سيتم طلب معاودة الاتصال مع ضبط runtime.lastError
.
المَعلمات
-
id
سلسلة
يجب أن يكون هذا المعرّف من عنصر
management.ExtensionInfo
. -
الخيارات
UninstallOptions اختيارية
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
uninstallSelf()
chrome.management.uninstallSelf(
options?: UninstallOptions,
callback?: function,
)
يتم إلغاء تثبيت إضافة الاتصال. ملاحظة: يمكن استخدام هذه الدالة بدون طلب إذن "الإدارة" في البيان. لا تعمل هذه الدالة في البيئات المُدارة عندما لا يُسمح للمستخدم بإلغاء تثبيت الإضافة/التطبيق المحدّد.
المَعلمات
-
الخيارات
UninstallOptions اختيارية
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 88 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من 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
سلسلة
-