הפניית API

רוב התוספים צריכים גישה לממשקי API אחד או יותר של תוספים ל-Chrome כדי לפעול. במסמכי התיעוד האלה של ה-API מתוארים ממשקי ה-API שזמינים לשימוש בתוספים, ומוצגים תרחישים לדוגמה.

תכונות נפוצות ב-Extensions API

‫Extensions API מורכב ממרחב שמות שמכיל שיטות ומאפיינים לביצוע עבודות שקשורות לתוספים, ובדרך כלל, אבל לא תמיד, משדות מניפסט לקובץ manifest.json. לדוגמה, מרחב השמות chrome.action דורש אובייקט "action" במניפסט. בממשקי API רבים נדרשות גם הרשאות במניפסט.

השיטות בממשקי API של הרחבות הן אסינכרוניות, אלא אם צוין אחרת. שיטות אסינכרוניות מחזירות ערך באופן מיידי, בלי להמתין לסיום הפעולה שקוראת להן. כדי לקבל את התוצאות של השיטות האסינכרוניות האלה, צריך להשתמש בהבטחות.

ממשקי Chrome Extension API

accessibilityFeatures

אפשר להשתמש ב-chrome.accessibilityFeatures API כדי לנהל את תכונות הנגישות של Chrome. ה-API הזה מסתמך על אב הטיפוס ChromeSetting של API מסוג כדי לקבל ולהגדיר תכונות נגישות ספציפיות. כדי לקבל את מצבי התכונות, התוסף צריך לבקש הרשאה accessibilityFeatures.read. כדי לשנות את מצב התכונה, התוסף צריך את ההרשאה accessibilityFeatures.modify. שימו לב: accessibilityFeatures.modify לא מרמז על הרשאה של accessibilityFeatures.read.

פעולה
‫Chrome 88 ואילך MV3 ואילך

אפשר להשתמש ב-chrome.action API כדי לשלוט בסמל התוסף בסרגל הכלים של Google Chrome.

alarms

אפשר להשתמש ב-chrome.alarms API כדי לתזמן קוד להפעלה מעת לעת או בשעה ספציפית בעתיד.

אודיו
‫Chrome 59 ואילך ChromeOS בלבד

ממשק ה-API‏ chrome.audio מסופק כדי לאפשר למשתמשים לקבל מידע על מכשירי האודיו שמחוברים למערכת ולשלוט בהם. ה-API הזה זמין כרגע רק במצב קיוסק ב-ChromeOS.

סימניות

אפשר להשתמש ב-chrome.bookmarks API כדי ליצור סימניות, לארגן אותן ולבצע פעולות אחרות. אפשר גם לעיין במאמר בנושא Override Pages, שמתאר איך ליצור דף מותאם אישית של ניהול הסימניות.

browsingData

משתמשים ב-chrome.browsingData API כדי להסיר נתוני גלישה מהפרופיל המקומי של המשתמש.

certificateProvider
‫Chrome 46 ואילך ChromeOS בלבד

אפשר להשתמש ב-API הזה כדי לחשוף אישורים לפלטפורמה, והפלטפורמה יכולה להשתמש באישורים האלה לאימות TLS.

פקודות

אפשר להשתמש בממשק ה-API של הפקודות כדי להוסיף קיצורי דרך במקלדת שמפעילים פעולות בתוסף, למשל פעולה לפתיחת פעולת הדפדפן או לשליחת פקודה לתוסף.

contentSettings

אפשר להשתמש ב-chrome.contentSettings API כדי לשנות הגדרות שקובעות אם אתרים יכולים להשתמש בתכונות כמו קובצי Cookie,‏ JavaScript ויישומי פלאגין. באופן כללי יותר, הגדרות התוכן מאפשרות לכם להתאים אישית את ההתנהגות של Chrome ברמת האתר, במקום ברמה הגלובלית.

contextMenus

משתמשים ב-chrome.contextMenus API כדי להוסיף פריטים לתפריט ההקשר של Google Chrome. אתם יכולים לבחור לאילו סוגים של אובייקטים יחולו התוספים לתפריט ההקשר, כמו תמונות, היפר-קישורים ודפים.

קובצי Cookie

אפשר להשתמש ב-API של chrome.cookies כדי לשלוח שאילתות לגבי קובצי Cookie ולשנות אותם, ולקבל התראה כשהם משתנים.

debugger

‫chrome.debugger API משמש כהעברה חלופית לפרוטוקול לניפוי באגים מרחוק של Chrome. אפשר להשתמש ב-chrome.debugger כדי לצרף כרטיסייה אחת או יותר למכשיר, לנפות באגים ב-JavaScript, לשנות את ה-DOM ואת ה-CSS ועוד. משתמשים במאפיין Debuggee tabId כדי לטרגט כרטיסיות עם sendCommand ולנתב אירועים לפי tabId מתוך קריאות חוזרות (callback) של onEvent.

declarativeContent

אפשר להשתמש ב-chrome.declarativeContent API כדי לבצע פעולות בהתאם לתוכן של דף, בלי לבקש הרשאה לקרוא את התוכן של הדף.

declarativeNetRequest
‫Chrome 84 ואילך

משתמשים ב-chrome.declarativeNetRequest API כדי לחסום או לשנות בקשות רשת על ידי ציון כללים הצהרתיים. כך התוספים יכולים לשנות את בקשות הרשת בלי ליירט אותן ולראות את התוכן שלהן, ולכן הם מספקים יותר פרטיות.

desktopCapture

ממשק ה-API של Desktop Capture מצלם את התוכן של המסך, של חלונות נפרדים או של כרטיסיות נפרדות.

devtools.inspectedWindow

אפשר להשתמש ב-chrome.devtools.inspectedWindow API כדי ליצור אינטראקציה עם החלון שנבדק: לקבל את מזהה הכרטיסייה של הדף שנבדק, להעריך את הקוד בהקשר של החלון שנבדק, לטעון מחדש את הדף או לקבל את רשימת המשאבים בדף.

devtools.network

אפשר להשתמש ב-chrome.devtools.network API כדי לאחזר את המידע על בקשות הרשת שמוצגות בלוח הרשת של הכלים למפתחים.

devtools.panels

משתמשים ב-chrome.devtools.panels API כדי לשלב את התוסף בממשק המשתמש של חלון כלי הפיתוח: יוצרים חלוניות משלכם, ניגשים לחלוניות קיימות ומוסיפים סרגלי צד.

devtools.performance
‫Chrome 129 ואילך

אפשר להשתמש ב-chrome.devtools.performance API כדי להאזין לעדכונים של סטטוס ההקלטה בחלונית הביצועים בכלי הפיתוח.

devtools.recorder
‫Chrome 105 ואילך

משתמשים ב-chrome.devtools.recorder API כדי להתאים אישית את חלונית מכשיר ההקלטה בכלי הפיתוח.

dns
ערוץ פיתוח

משתמשים ב-chrome.dns API לפתרון DNS.

documentScan
‫Chrome 44 ואילך ChromeOS בלבד

אפשר להשתמש ב-chrome.documentScan API כדי לגלות ולאחזר תמונות מסורקי מסמכים שמחוברים למכשיר.

dom
‫Chrome 88 ואילך

שימוש ב-chrome.dom API כדי לגשת לממשקי DOM API מיוחדים לתוספים

הורדות

אתם יכולים להשתמש ב-chrome.downloads API כדי להתחיל, לעקוב, לשנות ולחפש הורדות באופן פרוגרמטי.

enterprise.deviceAttributes
‫Chrome 46 ואילך ‫ChromeOS בלבד נדרשת מדיניות

משתמשים ב-API ‏chrome.enterprise.deviceAttributes כדי לקרוא את מאפייני המכשיר. הערה: ה-API הזה זמין רק לתוספים שהותקנו לפי הגדרת האדמין דרך המדיניות הארגונית.

enterprise.hardwarePlatform

אפשר להשתמש ב-chrome.enterprise.hardwarePlatform API כדי לקבל את היצרן והדגם של פלטפורמת החומרה שבה הדפדפן פועל. הערה: ה-API הזה זמין רק לתוספים שהותקנו על ידי המדיניות הארגונית.

enterprise.login
בהמתנה ל-ChromeOS בלבד נדרשת מדיניות

משתמשים ב-chrome.enterprise.login API כדי לצאת מהפעלות משתמש. הערה: ממשק ה-API הזה זמין רק לתוספים שהותקנו על ידי מדיניות ארגונית בסשנים מנוהלים של ChromeOS.

enterprise.networkingAttributes
‫Chrome 85 ואילך ChromeOS בלבד נדרשת מדיניות

משתמשים ב-chrome.enterprise.networkingAttributes API כדי לקרוא מידע על הרשת הנוכחית. הערה: ה-API הזה זמין רק לתוספים שהותקנו לפי הגדרת האדמין דרך המדיניות הארגונית.

enterprise.platformKeys
ChromeOS בלבד נדרשת מדיניות

משתמשים ב-chrome.enterprise.platformKeys API כדי ליצור מפתחות ולהתקין אישורים למפתחות האלה. הפלטפורמה תנהל את האישורים, ואפשר להשתמש בהם לאימות TLS, לגישה לרשת או באמצעות תוסף אחר דרך chrome.platformKeys.

אירועים

מרחב השמות chrome.events מכיל סוגים נפוצים שמשמשים ממשקי API ששולחים אירועים כדי להודיע לכם כשקורה משהו מעניין.

extension

ל-chrome.extension API יש כלי עזר שאפשר להשתמש בהם בכל דף של תוסף. היא כוללת תמיכה בהעברת הודעות בין תוסף לבין סקריפטים של תוכן או בין תוספים, כפי שמתואר בפירוט במאמר בנושא העברת הודעות.

extensionTypes

‫chrome.extensionTypes API מכיל הצהרות על סוגים של תוספים ל-Chrome.

fileBrowserHandler
ChromeOS בלבד רק בחזית

משתמשים ב-API ‏chrome.fileBrowserHandler כדי להרחיב את דפדפן הקבצים של ChromeOS. לדוגמה, אתם יכולים להשתמש ב-API הזה כדי לאפשר למשתמשים להעלות קבצים לאתר שלכם.

fileSystemProvider
ChromeOS בלבד

אפשר להשתמש ב-chrome.fileSystemProvider API כדי ליצור מערכות קבצים שאפשר לגשת אליהן ממנהל הקבצים ב-ChromeOS.

fontSettings

משתמשים ב-chrome.fontSettings API כדי לנהל את הגדרות הגופן של Chrome.

gcm

משתמשים ב-chrome.gcm כדי לאפשר לאפליקציות ולתוספים לשלוח ולקבל הודעות דרך העברת הודעות בענן ב-Firebase ‏ (FCM).

היסטוריה

משתמשים ב-chrome.history API כדי ליצור אינטראקציה עם רשומת הדפדפן של הדפים שבוקרו. אפשר להוסיף, להסיר ולחפש כתובות URL בהיסטוריה של הדפדפן. כדי להחליף את דף ההיסטוריה בגרסה משלכם, אפשר לעיין במאמר בנושא החלפת דפים.

i18n

אפשר להשתמש בתשתית chrome.i18n כדי להטמיע בינאום בכל האפליקציה או התוסף.

זהות

משתמשים ב-chrome.identity API כדי לקבל אסימוני גישה מסוג OAuth2.

idle

אפשר להשתמש ב-chrome.idle API כדי לזהות מתי המצב של המחשב משתנה ממצב פעיל למצב לא פעיל.

input.ime
ChromeOS בלבד

משתמשים ב-chrome.input.ime API כדי להטמיע IME מותאם אישית ב-ChromeOS. כך התוסף יכול לטפל בהקשות על המקשים, להגדיר את ההרכב ולנהל את חלון האפשרויות.

instanceID
‫Chrome 44 ואילך

משתמשים ב-chrome.instanceID כדי לגשת לשירות Instance ID.

loginState
‫Chrome 78 ואילך ChromeOS בלבד

משתמשים ב-chrome.loginState API כדי לקרוא את מצב ההתחברות ולעקוב אחריו.

סרטונים

ממשק ה-API‏ chrome.management מספק דרכים לניהול אפליקציות ותוספים מותקנים.

התראות

אפשר להשתמש ב-chrome.notifications API כדי ליצור התראות מפורטות באמצעות תבניות ולהציג את ההתראות האלה למשתמשים במגש המערכת.

offscreen
‫Chrome 109 ואילך MV3 ואילך

אפשר להשתמש ב-offscreen API כדי ליצור ולנהל מסמכים מחוץ למסך.

תיבת כתובת חכמה

ה-API של סרגל הכתובות מאפשר לרשום מילת מפתח בסרגל הכתובות של Google Chrome, שנקרא גם סרגל הכתובות.

pageCapture

משתמשים ב-chrome.pageCapture API כדי לשמור כרטיסייה כ-MHTML.

הרשאות

כדי שהמשתמשים יבינו למה נדרשות הרשאות ויוכלו להעניק רק את ההרשאות ההכרחיות, כדאי להשתמש ב-API של chrome.permissions כדי לבקש הרשאות אופציונליות מוצהרות בזמן הריצה ולא בזמן ההתקנה.

platformKeys
‫Chrome 45 ואילך ChromeOS בלבד

משתמשים ב-chrome.platformKeys API כדי לגשת לאישורי לקוח שמנוהלים על ידי הפלטפורמה. אם המשתמש או המדיניות מעניקים את ההרשאה, תוסף יכול להשתמש באישור כזה בפרוטוקול האימות המותאם אישית שלו. לדוגמה, ההגדרה הזו מאפשרת שימוש באישורים שמנוהלים על ידי הפלטפורמה ברשתות VPN של צד שלישי (ראו chrome.vpnProvider).

power

אפשר להשתמש ב-chrome.power API כדי לבטל את התכונות של ניהול צריכת החשמל במערכת.

printerProvider
‫Chrome 44 ואילך

‫chrome.printerProvider API חושף אירועים שמשמשים את מרכז ההדפסה לשליחת שאילתות למדפסות שנשלטות על ידי תוספים, כדי לשאול על היכולות שלהן ולשלוח אליהן משימות הדפסה.

הדפסה
‫Chrome 81 ואילך ‫ChromeOS בלבד

משתמשים ב-chrome.printing API כדי לשלוח משימות הדפסה למדפסות שמותקנות ב-Chromebook.

printingMetrics
‫Chrome 79 ואילך ChromeOS בלבד נדרשת מדיניות

משתמשים ב-chrome.printingMetrics API כדי לאחזר נתונים על השימוש בהדפסה.

פרטיות

אפשר להשתמש ב-API‏ chrome.privacy כדי לשלוט בשימוש בתכונות ב-Chrome שיכולות להשפיע על הפרטיות של המשתמש. ה-API הזה מסתמך על אב הטיפוס ChromeSetting של ה-API מסוג כדי לקבל ולהגדיר את התצורה של Chrome.

processes
ערוץ פיתוח

משתמשים ב-chrome.processes API כדי ליצור אינטראקציה עם התהליכים של הדפדפן.

proxy

אפשר להשתמש ב-chrome.proxy API כדי לנהל את הגדרות ה-proxy של Chrome. ממשק ה-API הזה מסתמך על אב-טיפוס ChromeSetting מסוג API כדי לקבל ולהגדיר את הגדרות ה-proxy.

readingList
‫Chrome 120 ואילך MV3 ואילך

אפשר להשתמש ב-chrome.readingList API כדי לקרוא ולשנות את הפריטים ברשימת הקריאה.

runtime

אפשר להשתמש ב-chrome.runtime API כדי לאחזר את ה-service worker, להחזיר פרטים על המניפסט, להאזין לאירועים במחזור החיים של התוסף ולהגיב להם. אפשר גם להשתמש ב-API הזה כדי להמיר את הנתיב היחסי של כתובות URL לכתובות URL מלאות.

scripting
‫Chrome 88 ואילך MV3 ואילך

משתמשים ב-chrome.scripting API כדי להריץ סקריפט בהקשרים שונים.

search
‫Chrome 87 ואילך

משתמשים ב-chrome.search API כדי לחפש דרך ספק ברירת המחדל.

סשנים

אפשר להשתמש ב-chrome.sessions API כדי לשלוח שאילתות ולשחזר כרטיסיות וחלונות מסשן גלישה.

sidePanel
‫Chrome 114 ואילך ‫MV3 ואילך

אפשר להשתמש ב-chrome.sidePanel API כדי לארח תוכן בחלונית הצדדית של הדפדפן לצד התוכן הראשי של דף אינטרנט.

storage

משתמשים ב-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 125 ואילך ChromeOS בלבד נדרשת מדיניות

אפשר להשתמש ב-API‏ chrome.systemLog כדי לתעד יומני מערכת של Chrome מתוספים.

tabCapture

משתמשים ב-chrome.tabCapture API כדי ליצור אינטראקציה עם מדיה שמוזרמת מכרטיסיות.

tabGroups
‫Chrome 89 ואילך MV3 ואילך

אפשר להשתמש ב-chrome.tabGroups API כדי לתקשר עם מערכת הקיבוץ של כרטיסיות בדפדפן. אפשר להשתמש ב-API הזה כדי לשנות את קבוצות הכרטיסיות בדפדפן ולסדר אותן מחדש. כדי לקבץ כרטיסיות ולבטל את הקיבוץ שלהן, או כדי לברר אילו כרטיסיות נמצאות בקבוצות, משתמשים ב-API‏ chrome.tabs.

כרטיסיות

משתמשים ב-chrome.tabs API כדי ליצור אינטראקציה עם מערכת הכרטיסיות של הדפדפן. אתם יכולים להשתמש ב-API הזה כדי ליצור, לשנות ולסדר מחדש כרטיסיות בדפדפן.

topSites

אפשר להשתמש ב-chrome.topSites API כדי לגשת לאתרים המובילים (כלומר, האתרים שבהם מבקרים הכי הרבה) שמוצגים בדף הכרטיסייה החדשה. הם לא כוללים קיצורי דרך שהמשתמש התאים אישית.

tts

משתמשים ב-API של chrome.tts כדי להפעיל המרת טקסט לדיבור (TTS) מסונתז. אפשר גם לעיין בממשק ה-API הקשור ttsEngine, שמאפשר לתוסף להטמיע מנוע דיבור.

ttsEngine

משתמשים ב-chrome.ttsEngine API כדי להטמיע מנוע להמרת טקסט לדיבור(TTS) באמצעות תוסף. אם התוסף שלכם נרשם באמצעות ה-API הזה, הוא יקבל אירועים שמכילים ביטוי שצריך להקריא ופרמטרים אחרים, כשתוסף או אפליקציית Chrome משתמשים ב-API‏ tts כדי ליצור דיבור. התוסף יכול להשתמש בכל טכנולוגיית אינטרנט זמינה כדי לסנתז את הדיבור ולהוציא אותו, ולשלוח אירועים בחזרה לפונקציה הקוראת כדי לדווח על הסטטוס.

types

‫chrome.types API מכיל הצהרות על סוגים ב-Chrome.

userScripts
‫Chrome 120 ואילך MV3 ואילך

משתמשים ב-userScripts API כדי להריץ סקריפטים של משתמשים בהקשר של סקריפטים של משתמשים.

vpnProvider
‫Chrome 43 ואילך ChromeOS בלבד

משתמשים ב-chrome.vpnProvider API כדי להטמיע לקוח VPN.

טפט
‫Chrome 43 ואילך ChromeOS בלבד

משתמשים ב-chrome.wallpaper API כדי לשנות את הטפט ב-ChromeOS.

webAuthenticationProxy
‫Chrome 115 ואילך MV3 ואילך

‫chrome.webAuthenticationProxy API מאפשר לתוכנת שולחן עבודה מרוחק שפועלת במארח מרוחק ליירט בקשות של Web Authentication API ‏ (WebAuthn) כדי לטפל בהן בלקוח מקומי.

webNavigation

אפשר להשתמש ב-chrome.webNavigation API כדי לקבל התראות על הסטטוס של בקשות ניווט שנמצאות בתהליך.

webRequest

אפשר להשתמש ב-chrome.webRequest API כדי לצפות בתנועת הגולשים ולנתח אותה, ולעכב, לחסום או לשנות בקשות בזמן שהן בטיפול.

windows

אפשר להשתמש ב-chrome.windows API כדי ליצור אינטראקציה עם חלונות דפדפן. אפשר להשתמש ב-API הזה כדי ליצור, לשנות ולסדר מחדש חלונות בדפדפן.