Bu sayfa, Cloud Translation API ile çevrilmiştir.

API referansı

Çoğu uzantının çalışması için bir veya daha fazla Chrome uzantısı API'sine erişmesi gerekir. Bu API referansında, uzantılarda kullanılabilen API'ler açıklanmakta ve örnek kullanım alanları sunulmaktadır.

Yaygın Extensions API özellikleri

Extensions API, uzantıların çalışması için yöntemleri ve özellikleri içeren ve genellikle her zaman, manifest.json dosyasının manifest alanlarını içerir. Örneğin, chrome.action ad alanı için "action" nesnesi gerekir dosyası olarak ekleyebilirsiniz. Birçok API için manifest'te izinler de gereklidir.

Aksi belirtilmedikçe uzantı API'lerindeki yöntemler eşzamansızdır. Eşzamansız yöntemler, onları çağıran işlemin tamamlanmasını beklemeden hemen döndürülür. Bu eşzamansız yöntemlerin sonuçlarını almak için promise'ları kullanın.

Chrome Uzantı API'leri

accessibilityFeatures: Chrome'un erişilebilirlik özelliklerini yönetmek için chrome.accessibilityFeatures API'yi kullanın. Bu API, erişilebilirlik özelliklerini tek tek almak ve ayarlamak için API türündeki ChromeSetting prototipini kullanır. Özellik durumlarını almak için uzantının accessibilityFeatures.read iznini istemesi gerekir. Uzantının, özellik durumunu değiştirmek için accessibilityFeatures.modify iznine ihtiyacı vardır. accessibilityFeatures.modify işlevinin accessibilityFeatures.read iznini ima etmediğini unutmayın.
işlem: Chrome 88 ve sonraki sürümler MV3 ve sonraki sürümler

Google Chrome araç çubuğundaki uzantının simgesini kontrol etmek için chrome.action API'sini kullanın.
alarms: Kodu düzenli aralıklarla veya gelecekte belirli bir zamanda çalışacak şekilde planlamak için chrome.alarms API'yi kullanın.
ses: Chrome 59 ve sonraki sürümler Yalnızca ChromeOS

chrome.audio API, kullanıcıların sisteme bağlı ses cihazları hakkında bilgi edinmesine ve bu cihazları kontrol etmesine olanak tanır. Bu API şu anda yalnızca ChromeOS için kiosk modunda kullanılabilir.
yer işaretleri: Yer işaretleri oluşturmak, düzenlemek ve başka şekilde işlemek için chrome.bookmarks API'yi kullanın. Ayrıca, özel bir Yer İşareti Yöneticisi sayfası oluşturmak için kullanabileceğiniz Sayfaları Geçersiz Kılma konusuna da bakın.
browsingData: Bir kullanıcının yerel profilindeki tarama verilerini kaldırmak için chrome.browsingData API'yi kullanın.
certificateProvider: Chrome 46 ve sonraki sürümler Yalnızca ChromeOS

Sertifikaları, TLS kimlik doğrulamaları için bu sertifikaları kullanabilen platformda kullanıma sunmak için bu API'yi kullanın.
komutlar: Uzantınızda işlemleri tetikleyen klavye kısayolları (ör. tarayıcı eylemini açan veya uzantıya komut gönderen bir işlem) eklemek için komutlar API'sini kullanın.
contentSettings: Web sitelerinin çerez, JavaScript ve eklenti gibi özellikleri kullanıp kullanamayacağını kontrol eden ayarları değiştirmek için chrome.contentSettings API'yi kullanın. Daha genel bir ifadeyle içerik ayarları, Chrome'un davranışını genel olarak değil, site bazında özelleştirmenize olanak tanır.
contextMenus: Google Chrome'un içerik menüsüne öğe eklemek için chrome.contextMenus API'sini kullanın. İçerik menüsüne eklediğiniz öğelerin resim, köprü ve sayfa gibi nesne türlerini seçebilirsiniz.
cookies: Çerezleri sorgulamak ve değiştirmek ve değiştiklerinde bildirim almak için chrome.cookies API'yi kullanın.
hata ayıklayıcı: chrome.debugger API, Chrome'un uzak hata ayıklama protokolü için alternatif bir aktarım aracı olarak kullanılır. Ağ etkileşimi aracı üzerinden bir veya daha fazla sekme eklemek, JavaScript'te hata ayıklamak, DOM ve CSS'yi değiştirmek ve daha pek çok işlem için chrome.debugger kullanın. Sekmeleri sendCommand ile hedeflemek ve etkinlikleri onEvent geri çağırmalarından tabId'a göre yönlendirmek için Debuggee tabId mülkünü kullanın.
declarativeContent: Sayfanın içeriğini okuma izni gerekmeden, sayfanın içeriğine göre işlem yapmak için chrome.declarativeContent API'sini kullanın.
declarativeNetRequest: Chrome 84 ve sonraki sürümler

chrome.declarativeNetRequest API, bildirim temelli kurallar belirleyerek ağ isteklerini engellemek veya değiştirmek için kullanılır. Bu sayede uzantılar, ağ isteklerini araya girmeden ve içeriklerini görüntülemeden değiştirebilir. Böylece daha fazla gizlilik sağlanır.
desktopCapture: Desktop Capture API ekranın içeriğini, tek tek pencereleri veya tek tek sekmeleri yakalar.
devtools.inspectedWindow: İncelenen pencereyle etkileşimde bulunmak için chrome.devtools.inspectedWindow API'yi kullanın: İncelenen sayfanın sekme kimliğini alın, kodu incelenen pencere bağlamında değerlendirin, sayfayı yeniden yükleyin veya sayfadaki kaynakların listesini alın.
devtools.network: Geliştirici Araçları tarafından Ağ panelinde görüntülenen ağ istekleriyle ilgili bilgileri almak için chrome.devtools.network API'sini kullanın.
devtools.panels: Uzantmanızı Geliştirici Araçları pencere kullanıcı arayüzüne entegre etmek için chrome.devtools.panels API'yi kullanın: Kendi panellerinizi oluşturun, mevcut panellere erişin ve kenar çubukları ekleyin.
devtools.performance: Chrome 129 ve sonraki sürümler 'nı inceleyin.

Geliştirici Araçları'ndaki Performans panelinde, kayıt durumu güncellemelerini dinlemek için chrome.devtools.performance API'yi kullanın.
devtools.recorder: Chrome 105 ve üzeri sürümler

Geliştirici Araçları'ndaki Kaydedici panelini özelleştirmek için chrome.devtools.recorder API'yi kullanın.
dns: Yeni geliştirilenler kanalı

DNS çözünürlüğü için chrome.dns API'yi kullanın.
documentScan: Chrome 44 ve sonraki sürümler Yalnızca ChromeOS

Ekli doküman tarayıcılardan görüntü bulmak ve almak için chrome.documentScan API'yi kullanın.
dom: Chrome 88 ve sonraki sürümler

Uzantılar için özel DOM API'lerine erişmek üzere chrome.dom API'yi kullanın
downloads: İndirme işlemlerini programatik olarak başlatmak, izlemek, işlemek ve aramak için chrome.downloads API'yi kullanın.
enterprise.deviceAttributes: Chrome 46 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Cihaz özelliklerini okumak için chrome.enterprise.deviceAttributes API'yi kullanın. Not: Bu API yalnızca kurumsal politika tarafından zorunlu olarak yüklenmiş uzantılar için kullanılabilir.
enterprise.hardwarePlatform: Chrome 71 ve sonraki sürümler Politika gerektirir

Tarayıcının çalıştığı donanım platformunun üreticisini ve modelini almak için chrome.enterprise.hardwarePlatform API'yi kullanın. Not: Bu API yalnızca kurumsal politikaya göre yüklenen uzantılar tarafından kullanılabilir.
enterprise.networkingAttributes: Chrome 85 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Mevcut ağınızla ilgili bilgileri okumak için chrome.enterprise.networkingAttributes API'yi kullanın. Not: Bu API yalnızca kurumsal politika tarafından zorunlu olarak yüklenmiş uzantılar için kullanılabilir.
enterprise.platformKeys: Yalnızca ChromeOS 'nı inceleyin. Politika gerektirir

Anahtar oluşturmak ve bu anahtarlara sertifika yüklemek için chrome.enterprise.platformKeys API'yi kullanın. Sertifikalar platform tarafından yönetilir ve TLS kimlik doğrulaması, ağ erişimi veya chrome.platformKeys aracılığıyla diğer uzantılar tarafından kullanılabilir.
etkinlikler: chrome.events ad alanı, ilginç bir şey olduğunda sizi bilgilendirmek için etkinlik gönderen API'ler tarafından kullanılan yaygın türleri içerir.
extension: chrome.extension API, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar içerir. Mesaj Geçişi bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içeriği komut dosyaları veya uzantılar arasında mesaj alışverişi için destek içerir.
extensionTypes: chrome.extensionTypes API, Chrome uzantıları için tür bildirimleri içerir.
fileBrowserHandler: Yalnızca ChromeOS Yalnızca ön plan

Chrome OS dosya tarayıcısını genişletmek için chrome.fileBrowserHandler API'yi kullanın. Örneğin, kullanıcıların web sitenize dosya yüklemesine izin vermek için bu API'yi kullanabilirsiniz.
fileSystemProvider: Yalnızca ChromeOS

Chrome OS'teki dosya yöneticisinden erişilebilen dosya sistemleri oluşturmak için chrome.fileSystemProvider API'yi kullanın.
fontSettings: Chrome'un yazı tipi ayarlarını yönetmek için chrome.fontSettings API'yi kullanın.
gcm: Uygulamaları ve uzantıları Firebase Cloud Messaging (FCM) üzerinden mesaj gönderip alacak şekilde etkinleştirmek için chrome.gcm kullanın.
history: Tarayıcının ziyaret edilen sayfalarıyla ilgili kaydıyla etkileşimde bulunmak için chrome.history API'yi kullanın. Tarayıcının geçmişindeki URL'leri ekleyebilir, kaldırabilir ve sorgulayabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları Geçersiz Kılma bölümüne bakın.
i18n: Uygulamanızın veya uzantınızın tamamında uluslararasılaştırma sağlamak için chrome.i18n altyapısını kullanın.
identity: OAuth2 erişim jetonları almak için chrome.identity API'yi kullanın.
idle: Makinenin boş durumdaki durumunun ne zaman değiştiğini algılamak için chrome.idle API'yi kullanın.
input.ime: Yalnızca ChromeOS

Chrome OS için özel bir IME uygulamak üzere chrome.input.ime API'yi kullanın. Bu sayede uzantınız tuş vuruşlarını işleyebilir, kompozisyonu ayarlayabilir ve aday penceresini yönetebilir.
instanceID: Chrome 44 ve sonraki sürümler

Örnek Kimliği hizmetine erişmek için chrome.instanceID kullanın.
loginState: Chrome 78 ve sonraki sürümler Yalnızca ChromeOS

Giriş durumunu okumak ve izlemek için chrome.loginState API'yi kullanın.
yönetimi: chrome.management API, yüklü uygulamaları ve uzantıları yönetmenin yollarını sağlar.
notifications: Şablonları kullanarak zengin bildirimler oluşturmak ve bu bildirimleri sistem tepsisinde kullanıcılara göstermek için chrome.notifications API'sını kullanın.
ekran dışı: Chrome 109 ve sonraki sürümler MV3+

Ekran dışı dokümanlar oluşturmak ve yönetmek için offscreen API'yi kullanın.
omnibox: Çok amaçlı adres çubuğu API'sı, çok amaçlı adres çubuğu olarak da bilinen Google Chrome'un adres çubuğuna anahtar kelimeleri kaydetmenize olanak tanır.
pageCapture: Bir sekmeyi MHTML olarak kaydetmek için chrome.pageCapture API'sini kullanın.
izinler: Beyan edilen isteğe bağlı izinleri yükleme zamanından ziyade çalışma zamanında istemek için chrome.permissions API'yi kullanın. Böylece kullanıcılar izinlerin neden gerekli olduğunu anlayıp yalnızca gerekli olanları verir.
platformKeys: Chrome 45 ve üzeri sürümler Yalnızca ChromeOS

Platform tarafından yönetilen istemci sertifikalarına erişmek için chrome.platformKeys API'yi kullanın. Kullanıcı veya politika izin verirse uzantı, özel kimlik doğrulama protokolünde bu tür bir sertifika kullanabilir. Ör. Bu ayar, üçüncü taraf VPN'lerde platform tarafından yönetilen sertifikaların kullanılmasına izin verir (chrome.vpnProvider sayfasına bakın).
power: Sistemin güç yönetimi özelliklerini geçersiz kılmak için chrome.power API'yi kullanın.
printerProvider: Chrome 44 ve sonraki sürümler

chrome.printerProvider API, yazıcı yöneticisinin uzantılar tarafından kontrol edilen yazıcıları sorgulamak, özelliklerini sorgulamak ve bu yazıcılara yazdırma işleri göndermek için kullandığı etkinlikleri gösterir.
printing: Chrome 81 ve sonraki sürümler Yalnızca ChromeOS

Yazdırma işlerini Chromebook'ta yüklü yazıcılara göndermek için chrome.printing API'yi kullanın.
printingMetrics: Chrome 79 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Baskı kullanımıyla ilgili verileri almak için chrome.printingMetrics API'yi kullanın.
gizlilik: Chrome'da kullanıcı gizliliğini etkileyebilecek özelliklerin kullanımını kontrol etmek için chrome.privacy API'yi kullanın. Bu API, Chrome'un yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır.
işlemler: Yeni geliştirilenler kanalı 'nı inceleyin.

Tarayıcı işlemlerinizle etkileşim kurmak için chrome.processes API'yi kullanın.
proxy: Chrome'un proxy ayarlarını yönetmek için chrome.proxy API'yi kullanın. Bu API, proxy yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır.
readingList: Chrome 120 ve sonraki sürümler MV3+

Okuma Listesi'ndeki öğelerde okuma ve değişiklik yapmak için chrome.readingList API'sini kullanın.
çalışma zamanı: Hizmet çalışanını almak, manifest ile ilgili ayrıntıları döndürmek ve uzantı yaşam döngüsündeki etkinlikleri dinlemek ve bunlara yanıt vermek için chrome.runtime API'yi kullanın. Bu API'yi, URL'lerin göreli yolunu tam nitelikli URL'lere dönüştürmek için de kullanabilirsiniz.
komut dosyası oluşturma: Chrome 88 ve sonraki sürümler MV3 ve sonraki sürümler

Komut dosyasını farklı bağlamlarda yürütmek için chrome.scripting API'yi kullanın.
search: Chrome 87 ve sonraki sürümler 'nı inceleyin.

Varsayılan sağlayıcı üzerinden arama yapmak için chrome.search API'yi kullanın.
oturumlar: Bir tarama oturumundaki sekmeleri ve pencereleri sorgulamak ve geri yüklemek için chrome.sessions API'yi kullanın.
sidePanel: Chrome 114 ve üzeri sürümler MV3 ve üzeri sürümler

Bir web sayfasının ana içeriğinin yanında tarayıcı yan panelinde içerik barındırmak için chrome.sidePanel API'yi kullanın.
storage: Kullanıcı verilerini depolamak, almak ve izlemek için chrome.storage API'yi kullanın.
system.cpu: CPU meta verilerini sorgulamak için system.cpu API'yi kullanın.
system.display: Ekran meta verilerini sorgulamak için system.display API'sini kullanın.
system.memory: chrome.system.memory API.
system.storage: Depolama cihazı bilgilerini sorgulamak ve çıkarılabilir depolama cihazı takılıp çıkarıldığında bildirim almak için chrome.system.storage API'yi kullanın.
systemLog: Chrome 125 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Uzantıların Chrome sistem günlüklerini kaydetmek için chrome.systemLog API'yi kullanın.
tabCapture: Sekme medya akışlarıyla etkileşimde bulunmak için chrome.tabCapture API'sini kullanın.
tabGroups: Chrome 89 ve sonraki sürümler MV3+

Tarayıcının sekme gruplandırma sistemiyle etkileşime geçmek için chrome.tabGroups API'yi kullanın. Tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz. Sekmeleri gruplandırıp gruplandırmak veya gruplarda hangi sekmelerin bulunduğunu sorgulamak için chrome.tabs API'yi kullanın.
sekmeler: Tarayıcı sekme sistemiyle etkileşim kurmak için chrome.tabs API'yi kullanın. Bu API'yi tarayıcıda sekmeler oluşturmak, değiştirmek ve yeniden düzenlemek için kullanabilirsiniz.
topSites: Yeni sekme sayfasında gösterilen en popüler sitelere (ör. en çok ziyaret edilen siteler) erişmek için chrome.topSites API'yi kullanın. Bunlar, kullanıcı tarafından özelleştirilmiş kısayolları içermez.
tts: Sentezlenmiş metin okuma (TTS) özelliğini oynatmak için chrome.tts API'yi kullanın. Ayrıca, uzantıların konuşma motoru uygulamasına olanak tanıyan ilgili ttsEngine API'sine de bakın.
ttsEngine: Uzantı kullanarak metin okuma (TTS) motoru uygulamak için chrome.ttsEngine API'yi kullanın. Uzantılarınız bu API'yi kullanarak kaydedilirse herhangi bir uzantı veya Chrome uygulaması konuşma oluşturmak için tts API'yi kullandığında, seslendirilecek bir ifade ve diğer parametreleri içeren etkinlikler alır. Uzantı, konuşmayı sentezlemek ve yayınlamak için mevcut web teknolojilerinden herhangi birini kullanabilir ve durumu bildirmek için etkinlikleri çağıran işleve geri gönderebilir.
türler: chrome.types API, Chrome için tür bildirimleri içerir.
userScripts: Chrome 120 ve sonraki sürümler MV3+

Kullanıcı komut dosyalarını User Scripts bağlamında yürütmek için userScripts API'yi kullanın.
vpnProvider: Chrome 43 ve sonraki sürümler Yalnızca ChromeOS

VPN istemcisi uygulamak için chrome.vpnProvider API'yi kullanın.
wallpaper: Chrome 43 ve sonraki sürümler Yalnızca ChromeOS

ChromeOS duvar kağıdını değiştirmek için chrome.wallpaper API'yi kullanın.
webAuthenticationProxy: Chrome 115+ MV3+

chrome.webAuthenticationProxy API, uzak bir ana makinede çalışan uzak masaüstü yazılımının, Web Authentication API (WebAuthn) isteklerini yerel bir istemcide işlemek için müdahale etmesine olanak tanır.
webNavigation: Yayındaki navigasyon isteklerinin durumu hakkında bildirim almak için chrome.webNavigation API'yi kullanın.
webRequest: Trafiği gözlemleyip analiz etmek, yayındaki isteklere müdahale etmek, bunları engellemek veya değiştirmek için chrome.webRequest API'yi kullanın.
pencereler: Tarayıcı pencereleriyle etkileşimde bulunmak için chrome.windows API'yi kullanın. Tarayıcıda pencere oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz.