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.

Ortak Extensions API özellikleri

Uzantı API'si, uzantı işlemlerini gerçekleştirmek için yöntemler ve özellikler içeren bir ad alanından ve genellikle (ancak her zaman değil) manifest.json dosyası için manifest alanlarından oluşur. Örneğin, chrome.action ad alanı için manifest'te bir "action" nesnesi gerekir. Birçok API için manifest dosyasında izinler de gereklidir.

Aksi belirtilmedikçe uzantı API'lerindeki yöntemler eşzamanlı değildir. 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ısı 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 prototipinden yararlanır. Uzantının özellik durumlarını alabilmesi için accessibilityFeatures.read iznini istemesi gerekir. Uzantının, özellik durumunu değiştirmek için accessibilityFeatures.modify iznine ihtiyacı vardır. accessibilityFeatures.modify, accessibilityFeatures.read izni anlamına gelmez.

action
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'yi kullanın.

alarms

Kodu düzenli olarak veya gelecekte belirli bir zamanda çalışacak şekilde planlamak için chrome.alarms API'yi kullanın.

audio
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ımak için sağlanı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. Özel bir yer işareti yöneticisi sayfası oluşturmak için kullanabileceğiniz Sayfaları geçersiz kılma başlıklı makaleyi de inceleyin.

browsingData

Kullanıcının yerel profilinden göz atma verilerini kaldırmak için chrome.browsingData API'yi kullanın.

certificateProvider
Chrome 46 ve sonraki sürümler Yalnızca ChromeOS

Bu API'yi kullanarak sertifikalarınızı platforma gösterin. Platform, bu sertifikaları TLS kimlik doğrulamaları için kullanabilir.

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 çerezler, JavaScript ve eklentiler gibi özellikleri kullanıp kullanamayacakları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 bağlam menüsüne öğe eklemek için chrome.contextMenus API'yi kullanın. İçerik menüsü eklemelerinizin resim, köprü ve sayfa gibi nesne türleri için geçerli olup olmayacağını 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şimini ölçmek, JavaScript'de hata ayıklama yapmak, DOM ve CSS'yi değiştirmek ve daha fazlası için bir veya daha fazla sekmeye eklemek üzere chrome.debugger simgesini 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 bağlı işlemler yapmak için chrome.declarativeContent API'yi kullanın.

declarativeNetRequest
Chrome 84 ve üzeri sürümler

chrome.declarativeNetRequest API, açıklayıcı kurallar belirterek 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 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

Ağ panelinde Geliştirici Araçları tarafından görüntülenen ağ istekleri hakkındaki bilgileri almak için chrome.devtools.network API'yi 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 üzeri sürümler

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ümü için chrome.dns API'yi kullanın.

documentScan
Chrome 44 ve üzeri 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 kullanma

downloads

İndirmeleri programatik olarak başlatmak, izlemek, değiştirmek 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'yi yalnızca kurumsal politika tarafından zorunlu olarak yüklenen uzantılar kullanabilir.

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'yi yalnızca kurumsal politika tarafından yüklenen uzantılar kullanabilir.

enterprise.login
Beklemede Yalnızca ChromeOS Politika gerektirir

Yönetilen misafir oturumlarından çıkmak için chrome.enterprise.login API'yi kullanın. Not: Bu API'yi yalnızca ChromeOS Yönetilen Misafir oturumlarında kurumsal politika tarafından yüklenen uzantılar kullanabilir.

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'yi yalnızca kurumsal politika tarafından zorunlu olarak yüklenen uzantılar kullanabilir.

enterprise.platformKeys
Yalnızca ChromeOS 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'sinde, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar bulunur. 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ıyla ilgili tür tanımlarını 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

ChromeOS'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ın ve uzantıların Firebase Cloud Messaging (FCM) üzerinden mesaj gönderip almasını sağlamak için chrome.gcm simgesini kullanın.

history

Tarayıcıda ziyaret edilen sayfaların kaydıyla etkileşimde bulunmak için chrome.history API'yi kullanın. Tarayıcı geçmişine URL ekleyebilir, mevcut URL'leri kaldırabilir ve URL'leri sorgulayabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları geçersiz kılma başlıklı makaleyi inceleyin.

i18n

Uygulamanızın veya uzantınızın tamamında uluslararasılaştırmayı uygulamak için chrome.i18n altyapısını kullanın.

identity

OAuth2 erişim jetonları almak için chrome.identity API'sini 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 üzeri 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'yi kullanın.

offscreen
Chrome 109 ve üzeri MV3 ve üzeri

Ekran dışı dokümanlar oluşturmak ve yönetmek için offscreen API'yi kullanın.

omnibox

Her şey bir arada kutusu API'si, bir anahtar kelimeyi Google Chrome'un her şey bir arada kutusu olarak da bilinen adres çubuğuna kaydetmenize olanak tanır.

pageCapture

Bir sekmeyi MHTML olarak kaydetmek için chrome.pageCapture API'sini kullanın.

permissions

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'sini kullanın. Kullanıcı veya politika izin verirse uzantı, özel kimlik doğrulama protokolünde bu tür bir sertifika kullanabilir. Örneğin, bu ayar üçüncü taraf VPN'lerde platform tarafından yönetilen sertifikaların kullanılmasına olanak tanır (chrome.vpnProvider bölümüne bakın).

power

Sistemin güç yönetimi özelliklerini geçersiz kılmak için chrome.power API'yi kullanın.

printerProvider
Chrome 44 ve üzeri 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 üstü Yalnızca ChromeOS

Chromebook'a yüklü yazıcılara yazdırma işleri 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'daki 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ündeki ChromeSetting prototipini kullanır.

işlemler
Yeni geliştirilenler kanalı

Tarayıcı işlemlerini etkileşime geçirmek 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ündeki ChromeSetting prototipini kullanır.

readingList
Chrome 120+ MV3+

Okuma Listesi'ndeki öğeleri okumak ve değiştirmek için chrome.readingList API'yi kullanın.

runtime

Hizmet işçisini almak, manifest ile ilgili ayrıntıları döndürmek ve uzantı yaşam döngüsündeki etkinlikleri dinleyip yanıtlamak için chrome.runtime API'yi kullanın. URL'lerin göreceli yolunu tam nitelikli URL'lere dönüştürmek için de bu API'yi kullanabilirsiniz.

scripting
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

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ı verilerindeki değişiklikleri 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

Görüntülü reklam meta verilerini sorgulamak için system.display API'yi kullanın.

system.memory

chrome.system.memory API'si.

system.storage

Depolama cihazı bilgilerini sorgulamak ve çıkarılabilir depolama cihazı takıldığında ve çıkarıldığında bildirim almak için chrome.system.storage API'yi kullanın.

systemLog
Chrome 125 ve üzeri 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şime geçmek için chrome.tabCapture API'yi kullanın.

tabGroups
Chrome 89 ve üzeri MV3 ve üzeri

Tarayıcı 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ırmak ve grupları çözmek ya da gruplardaki sekmeleri sorgulamak için chrome.tabs API'yi kullanın.

sekmeler

Tarayıcı sekme sistemiyle etkileşime geçmek için chrome.tabs API'yi kullanın. Tarayıcıda sekme oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi 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. Kullanıcı tarafından özelleştirilen kısayollar bu kapsamda değildir.

tts

Sentezlenmiş metin okuma (TTS) özelliğini oynatmak için chrome.tts API'yi kullanın. Ayrıca, bir uzantının konuşma motoru uygulamasına izin veren ilgili ttsEngine API'ye 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. Ardından uzantınız, konuşmayı sentezlemek ve yayınlamak için mevcut herhangi bir web teknolojisini kullanabilir ve durumu bildirmek için etkinlikleri çağıran işleve geri gönderebilir.

types

chrome.types API'si, Chrome için tür tanımlarını içerir.

userScripts
Chrome 120+ 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 isteklere müdahale etmesine olanak tanır.

webNavigation

Gezinme isteklerinin durumuyla ilgili bildirimler almak için chrome.webNavigation API'yi kullanın.

webRequest

Trafiği gözlemlemek ve analiz etmek, aktarımdaki istekleri durdurmak, engellemek veya değiştirmek için chrome.webRequest API'yi kullanın.

windows

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.