افزونه‌های Manifest V2 در تاریخ ۳۱ آگوست ۲۰۲۶ از فروشگاه وب کروم حذف شدند. افزونه خود را به Manifest V3 منتقل کنید تا دوباره در دسترس کاربران قرار گیرد. افزونه‌های Manifest V2 در تاریخ ۳۱ آگوست ۲۰۲۶ از فروشگاه وب کروم حذف شدند. افزونه خود را به Manifest V3 منتقل کنید تا دوباره در دسترس کاربران قرار گیرد. افزونه‌های Manifest V2 در تاریخ ۳۱ آگوست ۲۰۲۶ از فروشگاه وب کروم حذف شدند. افزونه خود را به Manifest V3 منتقل کنید تا دوباره در دسترس کاربران قرار گیرد.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

مرجع میانای برنامه‌سازی کاربردی

refresh date: 2026-09-25 robots: noindex

اکثر افزونه‌ها برای کار کردن به دسترسی به یک یا چند Chrome Extensions API نیاز دارند. این مرجع میانای برنامه‌سازی کاربردی، میاناهای برنامه‌سازی کاربردی دردسترس برای استفاده در افزونه‌ها را شرح می‌دهد و نمونه‌هایی از موارد استفاده را ارائه می‌کند.

accessibilityFeatures: از chrome.accessibilityFeatures API برای مدیریت ویژگی‌های دسترس‌پذیری Chrome استفاده کنید. این API برای دریافت و تنظیم ویژگی‌های دسترس‌پذیری فردی به نمونه اولیه ChromeSetting از نوع API متکی است. برای دریافت وضعیت‌های ویژگی، افزونه باید اجازه accessibilityFeatures.read را درخواست کند. برای اصلاح وضعیت ویژگی، افزونه به اجازه accessibilityFeatures.modify نیاز دارد. توجه داشته باشید که accessibilityFeatures.modify به‌معنای اجازه accessibilityFeatures.read نیست.
زنگ‌های ساعت: از میانای برنامه‌سازی کاربردی chrome.alarms برای زمان‌بندی کد برای اجرا به‌صورت دوره‌ای یا در زمان مشخصی در آینده استفاده کنید.
صدا: Chrome نسخه ۵۹ و بالاتر فقط ChromeOS

chrome.audio API برای این ارائه شده است که به کاربران اجازه دهد اطلاعاتی درباره دستگاه‌های صوتی متصل به سیستم دریافت کنند و آن‌ها را کنترل کنند. این API درحال‌حاضر فقط در حالت کیوسک برای ChromeOS دردسترس است.
نشانک‌ها: از chrome.bookmarks API برای ایجاد، سازمان‌دهی، و دستکاری نشانک‌ها استفاده کنید. همچنین صفحه‌های لغو را ببینید که می‌توانید از آن برای ایجاد صفحه سفارشی «مدیر نشانک» استفاده کنید.
browserAction: &leq; MV2

از کنش‌های مرورگر برای قرار دادن نمادها در نوارابزار اصلی Google Chrome، در سمت چپ نوار نشانی استفاده کنید. علاوه‌بر نماد، کنش مرورگر می‌تواند نکته‌ابزار، نشان، و بالاپر داشته باشد.
browsingData: از chrome.browsingData API برای برداشتن داده‌های مرور از نمایه محلی کاربر استفاده کنید.
certificateProvider: Chrome نسخه ۴۶ به بالا فقط ChromeOS

از این میانای برنامه‌سازی کاربردی برای نمایش گواهینامه‌ها به پلاتفرمی استفاده کنید که می‌تواند از این گواهینامه‌ها برای اصالت‌سنجی‌های «امنیت لایه انتقال» استفاده کند.
فرمان‌ها: از commands API برای افزودن میان‌برهای صفحه‌کلید استفاده کنید که کنش‌ها را در افزونه شما راه‌اندازی می‌کنند، برای مثال، کنشی برای باز کردن کنش مرورگر یا ارسال فرمان به افزونه.
contentSettings: از chrome.contentSettings API برای تغییر تنظیماتی استفاده کنید که کنترل می‌کنند آیا وب‌سایت‌ها می‌توانند از ویژگی‌هایی مانند کوکی‌ها، جاوااسکریپت و افزونه‌ها استفاده کنند. به‌طور کلی، تنظیمات محتوا به شما امکان می‌دهد رفتار Chrome را به‌جای اینکه به‌صورت سراسری سفارشی‌سازی کنید، به‌صورت جداگانه برای هر سایت سفارشی‌سازی کنید.
contextMenus: از chrome.contextMenus API برای افزودن موارد به منوِ بافت Google Chrome استفاده کنید. می‌توانید انتخاب کنید که موارد اضافه‌شده به منوی بافت برای چه نوع اشیایی اعمال شود، مثلاً تصاویر، اَبَرپیوندها، و صفحه‌ها.
کوکی‌ها: از chrome.cookies API برای پرسمان و اصلاح کوکی‌ها و دریافت اعلان هنگام تغییر آن‌ها استفاده کنید.
اشکال‌زدا: chrome.debugger API به‌عنوان انتقال جایگزین برای پروتکل اشکال‌زدایی از راه دور Chrome عمل می‌کند. از chrome.debugger برای پیوست کردن به یک یا چند برگه برای ابزارسازی تعامل شبکه، اشکال‌زدایی جاوا اسکریپت، تغییر DOM و CSS، و موارد دیگر استفاده کنید. از ویژگی Debuggee tabId برای هدف‌یابی برگه‌ها با sendCommand و مسیریابی رویدادها با tabId از فراخوانی‌های برگشتی onEvent استفاده کنید.
declarativeContent: از chrome.declarativeContent API برای انجام اقدامات براساس محتوای صفحه استفاده کنید، بدون اینکه به اجازه خواندن محتوای صفحه نیاز داشته باشید.
declarativeNetRequest: Chrome نسخه ۸۴ و بالاتر

از chrome.declarativeNetRequest API برای مسدود کردن یا اصلاح درخواست‌های شبکه با مشخص کردن قوانین اعلانی استفاده می‌شود. این کار به افزونه‌ها اجازه می‌دهد درخواست‌های شبکه را بدون رهگیری آن‌ها و مشاهده محتوایشان اصلاح کنند، بنابراین حریم خصوصی بیشتری فراهم می‌شود.
declarativeWebRequest: کانال بتا &leq; MV2

توجه: این میانای برنامه‌سازی کاربردی منسوخ شده است. به‌جای آن، declarativeNetRequest API را بررسی کنید. از chrome.declarativeWebRequest API برای رهگیری، مسدود کردن، یا اصلاح درخواست‌های درحال اجرا استفاده کنید. این API به‌طور قابل‌توجهی سریع‌تر از chrome.webRequest API است زیرا می‌توانید قوانینی را ثبت کنید که به‌جای موتور جاوا اسکریپت در مرورگر ارزیابی می‌شوند، که این امر تأخیرهای رفت‌وبرگشت را کاهش می‌دهد و کارایی بالاتری را ممکن می‌سازد.
desktopCapture: Desktop Capture API محتوای صفحه‌نمایش، پنجره‌های تکی، یا برگه‌های تکی را ضبط می‌کند.
devtools.inspectedWindow: از chrome.devtools.inspectedWindow API برای تعامل با پنجره بازرسی‌شده استفاده کنید: شناسه برگه را برای صفحه بازرسی‌شده دریافت کنید، کد را در زمینه پنجره بازرسی‌شده ارزیابی کنید، صفحه را مجدداً بار کنید، یا فهرست منابع درون صفحه را دریافت کنید.
devtools.network: از chrome.devtools.network API برای بازیابی اطلاعات مربوط به درخواست‌های شبکه که توسط «ابزارهای توسعه‌دهندگان» در پانل «شبکه» نمایش داده می‌شود استفاده کنید.
devtools.panels: از میانای برنامه‌سازی کاربردی chrome.devtools.panels برای ادغام افزونه‌تان در میانای کاربر پنجره «ابزارهای توسعه‌دهندگان» استفاده کنید: پانل‌های خودتان را ایجاد کنید، به پانل‌های موجود دسترسی پیدا کنید، و نوارهای کناری اضافه کنید.
devtools.performance: Chrome نسخه ۱۲۹ و بالاتر

از chrome.devtools.performance API برای گوش دادن به به‌روزرسانی‌های وضعیت ضبط در پانل «عملکرد» در DevTools استفاده کنید.
devtools.recorder: Chrome نسخه ۱۰۵ و بالاتر

از chrome.devtools.recorder API برای سفارشی‌سازی پانل «ضبط‌صوت» در DevTools استفاده کنید.
dns: کانال برنامه‌نویس‌ها

از chrome.dns API برای وضوح dns استفاده کنید.
documentScan: Chrome نسخه ۴۴ و بالاتر فقط ChromeOS

از chrome.documentScan API برای پیدا کردن و بازیابی تصاویر از اسکنرهای سند متصل‌شده استفاده کنید.
dom: Chrome نسخه ۸۸ و بالاتر

از chrome.dom API برای دسترسی به APIهای DOM ویژه برای «افزونه‌ها» استفاده کنید
بارگیری‌ها: از میانای برنامه‌سازی کاربردی chrome.downloads برای شروع، نظارت، دستکاری، و جستجوی بارگیری‌ها به‌صورت برنامه‌ریزی‌شده استفاده کنید.
enterprise.deviceAttributes: Chrome نسخه ۴۶ و بالاتر فقط ChromeOS خط‌مشی لازم است

از chrome.enterprise.deviceAttributes API برای خواندن مشخصه‌های دستگاه استفاده کنید. توجه: این میانای برنامه‌سازی کاربردی فقط برای افزونه‌هایی دردسترس است که با خط‌مشی سازمانی نصب اجباری شده‌اند.
enterprise.hardwarePlatform: Chrome نسخه ۷۱ به بالا به خط‌مشی نیاز دارد

از میانای برنامه‌سازی کاربردی chrome.enterprise.hardwarePlatform برای دریافت سازنده و مدل پلاتفرم سخت‌افزاری که مرورگر در آن اجرا می‌شود استفاده کنید. توجه: این API فقط برای افزونه‌های نصب‌شده توسط خط‌مشی سازمانی دردسترس است.
enterprise.login: Chrome نسخه ۱۳۹ به بالا فقط ChromeOS خط‌مشی لازم است

از میانای برنامه‌سازی کاربردی chrome.enterprise.login برای خروج از جلسه‌های «مهمان مدیریت‌شده» استفاده کنید. توجه: این میانای برنامه‌سازی کاربردی فقط برای افزونه‌هایی دردسترس است که توسط خط‌مشی سازمانی در جلسه‌های «مهمان مدیریت‌شده» ChromeOS نصب شده‌اند.
enterprise.networkingAttributes: Chrome نسخه ۸۵ و بالاتر فقط ChromeOS خط‌مشی لازم است

از chrome.enterprise.networkingAttributes API برای خواندن اطلاعات مربوط به شبکه فعلی‌تان استفاده کنید. توجه: این میانای برنامه‌سازی کاربردی فقط برای افزونه‌هایی دردسترس است که با خط‌مشی سازمانی نصب اجباری شده‌اند.
enterprise.platformKeys: فقط ChromeOS خط‌مشی لازم است

از chrome.enterprise.platformKeys API برای تولید کلیدها و نصب گواهینامه‌ها برای این کلیدها استفاده کنید. گواهینامه‌ها توسط پلاتفرم مدیریت خواهند شد و می‌توانند برای اصالت‌سنجی TLS، دسترسی به شبکه، یا توسط افزونه‌های دیگر ازطریق chrome.platformKeys استفاده شوند.
رویدادها: فضای نام chrome.events حاوی انواع رایجی است که میاناهای برنامه‌سازی کاربردی برای ارسال رویدادها استفاده می‌کنند تا وقتی اتفاق جالبی می‌افتد به شما اطلاع دهند.
افزونه: chrome.extension API دارای ابزارهایی است که هر صفحه افزونه‌ای می‌تواند از آن‌ها استفاده کند. این شامل پشتیبانی از تبادل پیام بین یک افزونه و اسکریپت‌های محتوای آن یا بین افزونه‌ها می‌شود، همانطور که به‌طور مفصل در انتقال پیام توضیح داده شده است.
extensionTypes: ‫chrome.extensionTypes API حاوی اعلان‌های نوع برای افزونه‌های Chrome است.
fileBrowserHandler: فقط ChromeOS فقط پیش‌زمینه

از chrome.fileBrowserHandler API برای گسترش مرورگر فایل Chrome OS استفاده کنید. برای مثال، می‌توانید از این API استفاده کنید تا کاربران بتوانند فایل‌ها را در وب‌سایت شما بارگذاری کنند.
fileSystemProvider: فقط ChromeOS

از chrome.fileSystemProvider API برای ایجاد سیستم‌های فایل استفاده کنید که ازطریق مدیر فایل در Chrome OS قابل‌دسترسی است.
fontSettings: از chrome.fontSettings API برای مدیریت تنظیمات قلم Chrome استفاده کنید.
gcm: از chrome.gcm برای فعال کردن برنامه‌ها و افزونه‌ها برای ارسال و دریافت پیام ازطریق پیام‌رسانی ابری Firebase (FCM) استفاده کنید.
سابقه: از chrome.history API برای تعامل با سابقه صفحه‌های بازدیدشده در مرورگر استفاده کنید. می‌توانید نشانی‌های وب را در سابقه مرورگر اضافه، حذف، و پُرسمان کنید. برای لغو کردن صفحه سابقه با نسخه خودتان، لغو کردن صفحه‌ها را ببینید.
i18n: از زیرساخت chrome.i18n برای پیاده‌سازی بین‌المللی‌سازی در کل برنامه یا افزونه‌تان استفاده کنید.
هویت: از chrome.identity API برای دریافت کدهای دسترسی OAuth2 استفاده کنید.
بیکار: از chrome.idle API برای تشخیص زمان تغییر وضعیت غیرفعال دستگاه استفاده کنید.
input.ime: فقط ChromeOS

از chrome.input.ime API برای پیاده‌سازی IME سفارشی برای Chrome OS استفاده کنید. این کار به افزونه شما اجازه می‌دهد تا کلیدهای فشرده‌شده را مدیریت کند، ترکیب‌بندی را تنظیم کند، و پنجره نامزد را مدیریت کند.
instanceID: Chrome نسخه ۴۴ به بالا

برای دسترسی به سرویس «شناسه نمونه»، از chrome.instanceID استفاده کنید.
loginState: Chrome نسخه ۷۸ و بالاتر فقط ChromeOS

از chrome.loginState API برای خواندن و نظارت بر وضعیت ورود به سیستم استفاده کنید.
مدیریت: chrome.management API روش‌هایی برای مدیریت برنامه‌ها و افزونه‌های نصب‌شده ارائه می‌دهد.
mimeHandler: Chrome نسخه ۱۵۱ و بالاتر

از chrome.mimeHandler API برای مدیریت جاری‌سازی‌های نوع MIME در افزونه‌های طرف سوم استفاده کنید.
اعلان‌ها: از میانای برنامه‌سازی کاربردی chrome.notifications برای ایجاد اعلان‌های غنی بااستفاده از الگوها و نمایش این اعلان‌ها به کاربران در سینی سیستم استفاده کنید.
omnibox: omnibox API به شما امکان می‌دهد کلیدواژه‌ای را در نوار نشانی Google Chrome (که omnibox نیز نامیده می‌شود) ثبت کنید.
pageAction: &leq; MV2

از chrome.pageAction API برای قرار دادن نمادها در نوارابزار اصلی Google Chrome، در سمت چپ نوار نشانی، استفاده کنید. کنش‌های صفحه نشان‌دهنده کنش‌هایی است که می‌توان در صفحه فعلی انجام داد، اما برای همه صفحه‌ها قابل‌اجرا نیست. کنش‌های صفحه وقتی غیرفعال باشند خاکستری می‌شوند.
pageCapture: از میانای برنامه‌سازی کاربردی chrome.pageCapture برای ذخیره کردن برگه به‌عنوان MHTML استفاده کنید.
اجازه‌ها: از chrome.permissions API برای درخواست اجازه‌های اختیاری اعلام‌شده در زمان اجرا به‌جای زمان نصب استفاده کنید تا کاربران متوجه شوند چرا این اجازه‌ها لازم است و فقط اجازه‌های ضروری را اعطا کنند.
platformKeys: Chrome نسخه ۴۵ به بالا فقط ChromeOS

از chrome.platformKeys API برای دسترسی به گواهینامه‌های کارخواه مدیریت‌شده توسط پلاتفرم استفاده کنید. اگر کاربر یا خط‌مشی اجازه را اعطا کند، افزونه می‌تواند از چنین گواهینامه‌ای در پروتکل اصالت‌سنجی سفارشی خود استفاده کند. برای مثال، این کار اجازه می‌دهد از گواهی‌های مدیریت‌شده پلاتفرم در وی‌پی‌ان‌های طرف سوم استفاده شود (chrome.vpnProvider را ببینید).
روشن/خاموش: از chrome.power API برای لغو ویژگی‌های مدیریت مصرف برق سیستم استفاده کنید.
printerProvider: Chrome نسخه ۴۴ به بالا

chrome.printerProvider API رویدادهای مورداستفاده مدیر چاپ را برای پرسمان چاپگرهای تحت کنترل افزونه‌ها، پرسمان قابلیت‌های آن‌ها، و ارسال کارهای چاپ به این چاپگرها نشان می‌دهد.
درحال چاپ: Chrome نسخه ۸۱ به بالا فقط ChromeOS

از chrome.printing API برای ارسال کارهای چاپ به چاپگرهای نصب‌شده در Chromebook استفاده کنید.
printingMetrics: Chrome نسخه ۷۹ و بالاتر فقط ChromeOS خط‌مشی لازم است

از میانای برنامه‌سازی کاربردی chrome.printingMetrics برای واکشی داده‌های مربوط به استفاده از چاپ استفاده کنید.
حریم خصوصی: از chrome.privacy API برای کنترل استفاده از ویژگی‌هایی در Chrome که می‌توانند بر حریم خصوصی کاربر تأثیر بگذارند استفاده کنید. این میانای برنامه‌سازی کاربردی برای دریافت و تنظیم پیکربندی Chrome به نمونه اولیه ChromeSetting از نوع میانای برنامه‌سازی کاربردی متکی است.
فرایندها: کانال برنامه‌نویس‌ها

از میانای برنامه‌سازی کاربردی chrome.processes برای تعامل با فرایندهای مرورگر استفاده کنید.
پراکسی: از میانای برنامه‌سازی کاربردی chrome.proxy برای مدیریت تنظیمات پراکسی Chrome استفاده کنید. این میانای برنامه‌سازی کاربردی برای دریافت و تنظیم پیکربندی پراکسی به نمونه اولیه ChromeSetting از نوع میانای برنامه‌سازی کاربردی متکی است.
publicSuffix: Chrome نسخه ۱۵۳ و بالاتر

از میانای برنامه‌سازی کاربردی chrome.publicSuffix برای پُرسمان «فهرست پسوند عمومی» (PSL) مرورگر استفاده کنید.
زمان اجرا: از chrome.runtime API برای بازیابی کارگر سرویس، برگرداندن جزئیات مانیفست، و گوش دادن و پاسخ دادن به رویدادها در چرخه حیات افزونه استفاده کنید. همچنین می‌توانید از این میانای برنامه‌سازی کاربردی برای تبدیل مسیر نسبی نشانی‌های وب به نشانی‌های وب کاملاً واجد شرایط استفاده کنید.
جستجو: Chrome نسخه ۸۷ به بالا

از chrome.search API برای جستجو ازطریق ارائه‌دهنده پیش‌فرض استفاده کنید.
جلسه‌ها: از chrome.sessions API برای پرسمان و بازیابی برگه‌ها و پنجره‌ها از جلسه مرور استفاده کنید.
فضای ذخیره‌سازی: از chrome.storage API برای ذخیره، بازیابی، و پیگیری تغییرات داده‌های کاربر استفاده کنید.
system.cpu: از system.cpu API برای پُرسمان فراداده‌های واحد پردازش مرکزی استفاده کنید.
system.display: از system.display API برای پرسمان فراداده نمایش استفاده کنید.
system.memory: chrome.system.memory API.
system.storage: از chrome.system.storage API برای جستجوی اطلاعات دستگاه ذخیره‌سازی استفاده کنید و وقتی دستگاه ذخیره‌سازی جداشدنی متصل یا جدا می‌شود، مطلع شوید.
systemLog: Chrome نسخه ۱۲۵ و بالاتر فقط ChromeOS به خط‌مشی نیاز دارد

از chrome.systemLog API برای ضبط گزارش‌های سیستم Chrome از افزونه‌ها استفاده کنید.
tabCapture: از chrome.tabCapture API برای تعامل با جاری‌سازی‌های رسانه برگه استفاده کنید.
برگه‌ها: از میانای برنامه‌سازی کاربردی chrome.tabs برای تعامل با سیستم برگه مرورگر استفاده کنید. می‌توانید از این API برای ایجاد، اصلاح، و بازآرایی برگه‌ها در مرورگر استفاده کنید.
topSites: از chrome.topSites API برای دسترسی به سایت‌های برتر (یعنی سایت‌های پربازدید) که در صفحه برگه جدید نمایش داده می‌شوند استفاده کنید. این میان‌برها شامل میان‌برهای سفارشی‌شده توسط کاربر نمی‌شود.
tts: از chrome.tts API برای پخش نوشتار به گفتار (TTS) ترکیبی استفاده کنید. همچنین ttsEngine API مرتبط را ببینید که به افزونه اجازه می‌دهد موتور گفتار را پیاده‌سازی کند.
ttsEngine: از chrome.ttsEngine API برای پیاده‌سازی موتور نوشتار به گفتار(TTS) بااستفاده از افزونه استفاده کنید. اگر افزونه شما بااستفاده از این API ثبت شود، وقتی هر افزونه یا «برنامه Chrome» از API tts برای تولید گفتار استفاده کند، رویدادهای حاوی گفته‌ای که باید بیان شود و پارامترهای دیگر را دریافت خواهد کرد. سپس افزونه شما می‌تواند از هر فناوری وب دردسترسی برای ترکیب و خروجی گفتار استفاده کند و رویدادها را برای گزارش وضعیت به تابع فراخواننده ارسال کند.
انواع: chrome.types API حاوی اعلان‌های نوع برای Chrome است.
vpnProvider: Chrome نسخه ۴۳ به بالا فقط ChromeOS

از chrome.vpnProvider API برای پیاده‌سازی کلاینت VPN استفاده کنید.
کاغذدیواری: Chrome نسخه ۴۳ به بالا فقط ChromeOS

از میانای برنامه‌سازی کاربردی chrome.wallpaper برای تغییر کاغذدیواری ChromeOS استفاده کنید.
webNavigation: از میانای برنامه‌سازی کاربردی chrome.webNavigation برای دریافت اعلان درباره وضعیت درخواست‌های ناوبری درحال انجام استفاده کنید.
webRequest: از chrome.webRequest API برای مشاهده و تجزیه‌وتحلیل ترافیک و رهگیری، مسدود کردن، یا اصلاح درخواست‌های درحال پردازش استفاده کنید.
windows: از chrome.windows API برای تعامل با پنجره‌های مرورگر استفاده کنید. می‌توانید از این API برای ایجاد، اصلاح، و بازآرایی پنجره‌ها در مرورگر استفاده کنید.

مرجع میانای برنامه‌سازی کاربردی با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

مرجع میانای برنامه‌سازی کاربردی