تاریخ بهروزرسانی: 2026-09-25 رباتها: noindex
توضیحات
رابط برنامهنویسی کاربردی chrome.management روشهایی برای مدیریت برنامهها و افزونههای نصبشده ارائه میدهد.
مجوزها
managementمانیفست
برای استفاده از API مدیریت، باید مجوز "مدیریت" را در مانیفست افزونه اعلام کنید. برای مثال:
{
"name": "My extension",
...
"permissions": [
"management"
],
...
}
management.getPermissionWarningsByManifest ، management.uninstallSelf و management.getSelf به مجوز مدیریت نیاز ندارند.
انواع
ExtensionDisabledReason
دلیلی برای غیرفعال بودن آیتم.
شمارشی
«ناشناخته» "افزایش_مجوزها"
ExtensionInfo
اطلاعات مربوط به افزونه، برنامه یا قالب نصبشده.
خواص
- appLaunchUrl
رشته اختیاری
آدرس اینترنتی راهاندازی (فقط برای برنامهها موجود است).
- انواع پرتاب موجود
نوع پرتاب [] اختیاری
انواع راهاندازی موجود فعلی (فقط برای برنامهها موجود است).
- توضیحات
رشته
شرح این افزونه، برنامه یا قالب.
- دلیل غیرفعال
دلیل غیرفعال شدن افزونه اختیاری است
دلیلی برای غیرفعال بودن آیتم.
- فعال شده
بولی
چه در حال حاضر فعال باشد و چه غیرفعال.
- آدرس صفحه اصلی
رشته اختیاری
نشانی اینترنتی صفحه اصلی این افزونه، برنامه یا قالب.
- مجوزهای میزبان
رشته[]
لیستی از مجوزهای مبتنی بر میزبان را برمیگرداند.
- آیکونها
IconInfo [] اختیاری
فهرستی از اطلاعات آیکونها. توجه داشته باشید که این فقط نشان دهندهی چیزی است که در مانیفست تعریف شده است و تصویر واقعی در آن آدرس اینترنتی ممکن است بزرگتر یا کوچکتر از چیزی باشد که تعریف شده است، بنابراین میتوانید از ویژگیهای عرض و ارتفاع صریح در تگهای img که به این تصاویر ارجاع میدهند، استفاده کنید. برای جزئیات بیشتر به مستندات مانیفست در مورد آیکونها مراجعه کنید.
- شناسه
رشته
شناسه منحصر به فرد افزونه.
- نوع نصب
نحوه نصب افزونه.
- ایاساپ
بولی
منسوخ شدهلطفا از
management.ExtensionInfo.typeاستفاده کنید.اگر این یک برنامه باشد، درست است.
- نوع پرتاب
نوع پرتاب اختیاری
نوع اجرای برنامه (فقط برای برنامهها موجود است).
- ممکن است غیرفعال شود
بولی
اینکه آیا این افزونه میتواند توسط کاربر غیرفعال یا حذف نصب شود یا خیر.
- ممکن است فعال شود
بولی اختیاری
کروم ۶۲+آیا این افزونه میتواند توسط کاربر فعال شود؟ این فقط برای افزونههایی که فعال نیستند، برگردانده میشود.
- نام
رشته
نام این افزونه، برنامه یا قالب.
- آفلاینفعال
بولی
اینکه آیا افزونه، برنامه یا قالب اعلام میکند که از حالت آفلاین پشتیبانی میکند یا خیر.
- گزینههایآدرس اینترنتی
رشته
نشانی اینترنتی صفحه گزینههای مربوط به کالا، در صورت وجود.
- مجوزها
رشته[]
لیستی از مجوزهای مبتنی بر API را برمیگرداند.
- نام کوتاه
رشته
نسخهٔ کوتاهی از نام این افزونه، برنامه یا قالب.
- نوع
نوع این افزونه، برنامه یا قالب.
- آدرس بهروزرسانی
رشته اختیاری
نشانی اینترنتی بهروزرسانی این افزونه، برنامه یا قالب.
- نسخه
رشته
نسخه این افزونه، برنامه یا قالب.
- نام نسخه
رشته اختیاری
کروم ۵۰+نام نسخه این افزونه، برنامه یا قالب، در صورتی که در مانیفست مشخص شده باشد.
ExtensionInstallType
نحوه نصب افزونه. یکی از موارد زیر: admin : افزونه به دلیل یک سیاست مدیریتی نصب شده است، development : افزونه در حالت توسعهدهنده به صورت آنپک بارگذاری شده است، normal : افزونه به طور عادی از طریق یک فایل .crx نصب شده است، sideload : افزونه توسط نرمافزار دیگری روی دستگاه نصب شده است، other : افزونه به روشهای دیگری نصب شده است.
شمارشی
"مدیر" «توسعه» "عادی" "بار جانبی" «دیگر»
ExtensionType
نوع این افزونه، برنامه یا قالب.
شمارشی
"امتداد" "برنامه_میزبانی شده" "برنامه_بستهبندیشده" "برنامه_بسته_بندی_شده_قدیمی" "تم" "افزونه_صفحه_ورود"
IconInfo
اطلاعات مربوط به یک آیکون متعلق به یک افزونه، برنامه یا قالب.
خواص
- اندازه
شماره
عددی که عرض و ارتفاع آیکون را نشان میدهد. مقادیر احتمالی شامل (اما نه محدود به) ۱۲۸، ۴۸، ۲۴ و ۱۶ هستند.
- آدرس اینترنتی
رشته
آدرس اینترنتی (URL) این تصویر آیکون. برای نمایش نسخه خاکستری آیکون (برای مثال، برای نشان دادن غیرفعال بودن یک افزونه)،
?grayscale=trueرا به آدرس اینترنتی اضافه کنید.
LaunchType
اینها همه انواع احتمالی راهاندازی برنامه هستند.
شمارشی
«باز کردن به صورت عادی» «باز کردن_به_صورت_پین_تب» «به عنوان پنجره باز شود» «تمام_صفحه_باز»
UninstallOptions
گزینههایی برای نحوه مدیریت حذف نصب افزونه.
خواص
- showConfirmDialog
بولی اختیاری
اینکه آیا باید کاربر از طریق پنجره تایید-حذف، پیغامی دریافت کند یا خیر. برای حذف خودکار، مقدار پیشفرض false است. اگر یک افزونه، افزونه دیگری را حذف نصب کند، این پارامتر نادیده گرفته میشود و پنجره همیشه نمایش داده میشود.
روشها
createAppShortcut()
chrome.management.createAppShortcut(
id: string,
callback?: function,
): Promise<void>
گزینههایی برای ایجاد میانبر برای یک برنامه نمایش داده میشود. در مک، فقط میتوان میانبرهای برنامههای بستهبندیشده را ایجاد کرد.
پارامترها
- شناسه
رشته
این باید شناسهی یک آیتم برنامه از
management.ExtensionInfoباشد. - تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
generateAppForLink()
chrome.management.generateAppForLink(
url: string,
title: string,
callback?: function,
): Promise<ExtensionInfo>
یک برنامه برای یک URL ایجاد میکند. برنامه نشانک تولید شده را برمیگرداند.
پارامترها
- آدرس اینترنتی
رشته
آدرس اینترنتی (URL) یک صفحه وب. طرح کلی URL فقط میتواند "http" یا "https" باشد.
- عنوان
رشته
عنوان برنامه تولید شده
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(result: ExtensionInfo) => void
- نتیجه
بازگشتها
قول< اطلاعات افزونه >
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
get()
chrome.management.get(
id: string,
callback?: function,
): Promise<ExtensionInfo>
اطلاعات مربوط به افزونه، برنامه یا قالب نصبشدهای که شناسهی دادهشده را دارد، برمیگرداند.
پارامترها
- شناسه
رشته
شناسهی یک آیتم از
management.ExtensionInfo. - تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(result: ExtensionInfo) => void
- نتیجه
بازگشتها
قول< اطلاعات افزونه >
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
getAll()
chrome.management.getAll(
callback?: function,
): Promise<ExtensionInfo[]>
فهرستی از اطلاعات مربوط به افزونهها و برنامههای نصبشده را برمیگرداند.
پارامترها
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(result: ExtensionInfo[]) => void
- نتیجه
بازگشتها
قول< اطلاعات افزونه []>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
getPermissionWarningsById()
chrome.management.getPermissionWarningsById(
id: string,
callback?: function,
): Promise<string[]>
فهرستی از هشدارهای مجوز را برای شناسه افزونه داده شده برمیگرداند.
پارامترها
- شناسه
رشته
شناسهی افزونهای که از قبل نصب شده است.
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(permissionWarnings: string[]) => void
- هشدارهای مجوز
رشته[]
بازگشتها
قول <string[]>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
getPermissionWarningsByManifest()
chrome.management.getPermissionWarningsByManifest(
manifestStr: string,
callback?: function,
): Promise<string[]>
لیستی از هشدارهای مجوز را برای رشته مانیفست افزونه داده شده برمیگرداند. توجه: این تابع را میتوان بدون درخواست مجوز 'management' در مانیفست استفاده کرد.
پارامترها
- مانیفستاستریت
رشته
رشته JSON مانیفست افزونه.
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(permissionWarnings: string[]) => void
- هشدارهای مجوز
رشته[]
بازگشتها
قول <string[]>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
getSelf()
chrome.management.getSelf(
callback?: function,
): Promise<ExtensionInfo>
اطلاعات مربوط به افزونه، برنامه یا قالب فراخوانی شده را برمیگرداند. توجه: این تابع را میتوان بدون درخواست مجوز «مدیریت» در مانیفست استفاده کرد.
پارامترها
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(result: ExtensionInfo) => void
- نتیجه
بازگشتها
قول< اطلاعات افزونه >
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
installReplacementWebApp()
chrome.management.installReplacementWebApp(
callback?: function,
): Promise<void>
برنامه replacement_web_app مشخص شده در مانیفست را اجرا میکند. اگر از قبل نصب نشده باشد، از کاربر میخواهد که آن را نصب کند.
پارامترها
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
launchApp()
chrome.management.launchApp(
id: string,
callback?: function,
): Promise<void>
یک برنامه کاربردی را اجرا میکند.
پارامترها
- شناسه
رشته
شناسه افزونه برنامه.
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
setEnabled()
chrome.management.setEnabled(
id: string,
enabled: boolean,
callback?: function,
): Promise<void>
یک برنامه یا افزونه را فعال یا غیرفعال میکند. در بیشتر موارد، این تابع باید در متن یک حرکت کاربر (مثلاً یک کنترلکنندهی onclick برای یک دکمه) فراخوانی شود و ممکن است به عنوان راهی برای جلوگیری از سوءاستفاده، یک رابط کاربری تأیید بومی را به کاربر ارائه دهد.
پارامترها
- شناسه
رشته
این باید شناسهی یک آیتم از
management.ExtensionInfoباشد. - فعال شده
بولی
اینکه آیا این مورد باید فعال یا غیرفعال باشد.
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
setLaunchType()
chrome.management.setLaunchType(
id: string,
launchType: LaunchType,
callback?: function,
): Promise<void>
نوع اجرای یک برنامه را تنظیم کنید.
پارامترها
- شناسه
رشته
این باید شناسهی یک آیتم برنامه از
management.ExtensionInfoباشد. - نوع پرتاب
نوع راهاندازی هدف. همیشه بررسی کنید و مطمئن شوید که این نوع راهاندازی در
ExtensionInfo.availableLaunchTypesقرار دارد، زیرا انواع راهاندازی موجود در پلتفرمها و پیکربندیهای مختلف متفاوت است. - تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
uninstall()
chrome.management.uninstall(
id: string,
options?: UninstallOptions,
callback?: function,
): Promise<void>
یک برنامه یا افزونهی نصبشدهی فعلی را حذف نصب میکند. نکته: این تابع در محیطهای مدیریتشده، زمانی که کاربر اجازهی حذف نصب افزونه/برنامهی مشخصشده را ندارد، کار نمیکند. اگر حذف ناموفق باشد (مثلاً کاربر دیالوگ را لغو کند)، promise رد میشود یا تابع فراخوانی با مقدار runtime.lastError تنظیمشده فراخوانی میشود.
پارامترها
- شناسه
رشته
این باید شناسهی یک آیتم از
management.ExtensionInfoباشد. - گزینهها
گزینههای حذف ( اختیاری)
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
uninstallSelf()
chrome.management.uninstallSelf(
options?: UninstallOptions,
callback?: function,
): Promise<void>
افزونهی فراخوانیشده را حذف نصب میکند. نکته: این تابع میتواند بدون درخواست مجوز «مدیریت» در مانیفست استفاده شود. این تابع در محیطهای مدیریتشده که کاربر مجاز به حذف نصب افزونه/برنامهی مشخصشده نیست، کار نمیکند.
پارامترها
- گزینهها
گزینههای حذف ( اختیاری)
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:() => void
بازگشتها
قول<void>
کروم ۸۸+Promiseها فقط برای Manifest V3 و نسخههای بعدی پشتیبانی میشوند، سایر پلتفرمها باید از callbackها استفاده کنند.
رویدادها
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
- شناسه
رشته