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