API referansı

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

Common Extensions API'nin ortak özellikleri

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

Uzantı API'lerindeki yöntemler aksi belirtilmedikçe eşzamansızdır. Eşzamansız yöntemler, kendilerini çağıran işlemin tamamlanmasını beklemeden hemen geri döner. Bu eşzamansız yöntemlerin sonuçlarını almak için promises kullanın.

Chrome Extension API'leri

accessibilityFeatures

Chrome'un erişilebilirlik özelliklerini yönetmek için chrome.accessibilityFeatures API'yi kullanın. Bu API, tek tek erişilebilirlik özelliklerini almak ve ayarlamak için ChromeSetting tür API'nin prototipine dayanır. Özellik durumlarını almak için uzantının accessibilityFeatures.read izni istemesi gerekir. Uzantının özellik durumunu değiştirmek için accessibilityFeatures.modify izni gerekir. accessibilityFeatures.modify izninin accessibilityFeatures.read izni anlamına gelmediğini unutmayın.

action
Chrome 88+ MV3+

Google Chrome araç çubuğundaki uzantı simgesini kontrol etmek için chrome.action API'sini kullanın.

alarms

Kodu periyodik olarak veya gelecekte belirli bir zamanda çalışacak şekilde planlamak için chrome.alarms API'sini 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'in kiosk modunda kullanılabilir.

yer işaretleri

Yer işaretlerini oluşturmak, düzenlemek ve başka şekillerde değiştirmek için chrome.bookmarks API'yi kullanın. Özel bir Yer İşareti Yöneticisi sayfası oluşturmak için kullanabileceğiniz Override Pages'e de bakın.

browsingData

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

certificateProvider
Chrome 46 veya daha yeni bir sürüm Yalnızca ChromeOS

Bu API'yi, sertifikaları platforma sunmak için kullanın. Platform, bu sertifikaları TLS kimlik doğrulamaları için kullanabilir.

commands

Uzantınızda işlemleri tetikleyen klavye kısayolları eklemek için Commands API'yi kullanın. Örneğin, tarayıcı işlemini açma veya uzantıya komut gönderme işlemleri.

contentSettings

Web sitelerinin çerezler, JavaScript ve eklentiler gibi özellikleri kullanıp kullanamayacaklarını belirleyen ayarları değiştirmek için chrome.contentSettings API'yi kullanın. Daha genel olarak, 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 hangi tür nesneler için geçerli olacağını (ör. resimler, köprüler ve sayfalar) seçebilirsiniz.

cookies

Çerezleri sorgulamak, değiştirmek ve değiştiğinde bildirim almak için chrome.cookies API'sini kullanın.

hata ayıklayıcı

chrome.debugger API, Chrome'un uzaktan hata ayıklama protokolü için alternatif bir aktarım görevi görür. Ağ etkileşimini ölçmek, JavaScript'te hata ayıklamak, DOM ve CSS'yi değiştirmek ve daha fazlası için chrome.debugger simgesini kullanarak bir veya daha fazla sekmeye bağlanın. Debuggee özelliğini kullanarak sendCommand ile sekmeleri hedefleyin ve onEvent geri çağırmalarından gelen etkinlikleri tabId ile yönlendirin.tabId

declarativeContent

Sayfa içeriğini okuma izni gerektirmeden, sayfa içeriğine bağlı olarak işlem yapmak için chrome.declarativeContent API'sini kullanın.

declarativeNetRequest
Chrome 84+

chrome.declarativeNetRequest API, bildirim temelli kurallar belirtilerek ağ isteklerini engellemek veya değiştirmek için kullanılır. Bu sayede uzantılar, ağ isteklerini engellemeden ve içeriklerini görüntülemeden değiştirebilir. Böylece daha fazla gizlilik sağlanır.

desktopCapture

Masaüstü Yakalama API'si, ekranın, bağımsız pencerelerin veya bağımsız sekmelerin içeriğini yakalar.

devtools.inspectedWindow

İncelenen pencereyle etkileşim kurmak için chrome.devtools.inspectedWindow API'sini 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österilen ağ istekleriyle ilgili bilgileri almak için chrome.devtools.network API'yi kullanın.

devtools.panels

Uzantınızı Geliştirici Araçları penceresi 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 veya daha yeni bir sürüm

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 veya daha yeni bir sürüm

Geliştirici Araçları'ndaki Kaydedici panelini özelleştirmek için chrome.devtools.recorder API'sini kullanın.

dns
Yeni geliştirilenler kanalı

DNS çözümlemesi için chrome.dns API'sini kullanın.

documentScan
Chrome 44 veya daha yeni bir sürüm Yalnızca ChromeOS

Ekli belge tarayıcılardan görüntüleri keşfetmek 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'sini kullanın.

downloads

İndirmeleri programatik olarak başlatmak, izlemek, değiştirmek ve aramak için chrome.downloads API'sini 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üklenen 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 politika tarafından yüklenen uzantılar için kullanılabilir.

enterprise.login
Beklemede Yalnızca ChromeOS Politika gerektirir

Kullanıcı oturumlarından çıkmak için chrome.enterprise.login API'yi kullanın. Not: Bu API yalnızca ChromeOS'teki yönetilen oturumlarda kurumsal politika tarafından 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üklenen uzantılar için kullanılabilir.

enterprise.platformKeys
Yalnızca ChromeOS Politika gerektirir

Bu anahtarlar için anahtar oluşturmak ve sertifika yüklemek üzere 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. Message Passing (Mesaj Geçirme) bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içerik komut dosyaları arasında veya uzantılar arasında mesaj alışverişi desteği içerir.

extensionTypes

chrome.extensionTypes API, Chrome uzantıları için tür bildirimlerini 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üklemesini sağlamak 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'sini kullanın.

fontSettings

Chrome'un yazı tipi ayarlarını yönetmek için chrome.fontSettings API'sini kullanın.

gcm

Uygulamaların ve uzantıların Firebase Cloud Messaging (FCM) üzerinden mesaj göndermesini ve almasını sağlamak için chrome.gcm kullanın.

history

Ziyaret edilen sayfaların tarayıcı kaydıyla etkileşimde bulunmak için chrome.history API'sini kullanın. Tarayıcının geçmişine URL ekleyebilir, URL 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ını almak için chrome.identity API'sini kullanın.

idle

Makinenin boşta kalma durumu değiştiğinde bunu 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 veya daha yeni bir sürüm

Örnek kimliği hizmetine erişmek için chrome.instanceID kullanın.

loginState
Chrome 78 ve sonraki sürümler Yalnızca ChromeOS

Oturum açma durumunu okumak ve izlemek için chrome.loginState API'yi kullanın.

yönetimi

chrome.management API, yüklü uygulamaları ve uzantıları yönetme yöntemleri sunar.

notifications

Şablonları kullanarak zengin bildirimler oluşturmak ve bu bildirimleri sistem tepsisindeki kullanıcılara göstermek için chrome.notifications API'sini kullanın.

offscreen
Chrome 109+ MV3+

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

omnibox

Omnibox API, Google Chrome'un adres çubuğuna (omnibox olarak da bilinir) bir anahtar kelime kaydetmenize olanak tanır.

pageCapture

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

izinler

Kullanıcıların izinlerin neden gerekli olduğunu anlaması ve yalnızca gerekli olanları vermesi için chrome.permissions API'sini kullanarak bildirilen isteğe bağlı izinleri yükleme zamanında değil, çalışma zamanında isteyin.

platformKeys
Chrome 45 ve sonraki 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 izni 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'a bakın).

power

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

printerProvider
Chrome 44 veya daha yeni bir sürüm

chrome.printerProvider API, yazdırma yöneticisi tarafından uzantılarla kontrol edilen yazıcıları sorgulamak, bu yazıcıların özelliklerini sorgulamak ve bu yazıcılara yazdırma işleri göndermek için kullanılan etkinlikleri kullanıma sunar.

baskı
Chrome 81 ve sonraki sürümler Yalnızca ChromeOS

Chromebook'a yüklenen yazıcılara yazdırma işleri göndermek için chrome.printing API'sini kullanın.

printingMetrics
Chrome 79 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Yazdırma kullanımıyla ilgili verileri getirmek için chrome.printingMetrics API'yi kullanın.

gizlilik

Kullanıcının gizliliğini etkileyebilecek Chrome özelliklerinin kullanımını kontrol etmek için chrome.privacy API'sini kullanın. Bu API, Chrome'un yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipine dayanır.

processes
Yeni geliştirilenler kanalı

Tarayıcının işlemleriyle 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 ChromeSetting türündeki API'nin ChromeSetting prototipine dayanır.

readingList
Chrome 120+ MV3+

chrome.readingList API'yi kullanarak Okuma Listesi'ndeki öğeleri okuyun ve değiştirin.

runtime

Service worker'ı almak, manifestle 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. Bu API'yi, URL'lerin göreceli yolunu tam nitelikli URL'lere dönüştürmek için de kullanabilirsiniz.

komut dosyası oluşturma
Chrome 88+ MV3+

Farklı bağlamlarda komut dosyası 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'sini kullanın.

oturumlar

Bir göz atma oturumundaki sekmeleri ve pencereleri sorgulamak ve geri yüklemek için chrome.sessions API'yi kullanın.

sidePanel
Chrome 114 veya daha yeni bir sürüm MV3 veya daha yeni bir sürüm

chrome.sidePanel API'yi kullanarak içeriği, tarayıcının yan panelinde bir web sayfasının ana içeriğiyle birlikte barındırın.

storage

Kullanıcı verilerinde yapılan değişiklikleri depolamak, almak ve izlemek için chrome.storage API'sini kullanın.

system.cpu

CPU meta verilerini sorgulamak için system.cpu API'yi kullanın.

system.display

Yayınlanan içerik 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 bir depolama cihazı takıldığında veya çıkarıldığında bildirim almak için chrome.system.storage API'sini kullanın.

systemLog
Chrome 125 ve sonraki sürümler Yalnızca ChromeOS Politika gerektirir

Uzantılardan Chrome sistem günlüklerini kaydetmek için chrome.systemLog API'yi kullanın.

tabCapture

Sekme medya akışlarıyla etkileşim kurmak için chrome.tabCapture API'sini kullanın.

tabGroups
Chrome 89+ MV3+

Tarayıcının sekme gruplandırma sistemiyle etkileşim kurmak için chrome.tabGroups API'yi kullanın. Bu API'yi, tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için kullanabilirsiniz. Sekmeleri gruplandırmak ve gruplarını çözmek ya da gruplardaki sekmeleri sorgulamak için chrome.tabs API'sini kullanın.

sekmeler

Tarayıcının sekme sistemiyle etkileşim kurmak için chrome.tabs API'sini kullanın. Bu API'yi kullanarak tarayıcıda sekmeler oluşturabilir, değiştirebilir ve yeniden düzenleyebilirsiniz.

topSites

Yeni sekme sayfasında gösterilen en popüler sitelere (ör. en çok ziyaret edilen siteler) erişmek için chrome.topSites API'sini kullanın. Bunlara, kullanıcı tarafından özelleştirilen kısayollar dahil değildir.

tts

Sentezlenmiş metin okuma (TTS) oynatmak için chrome.tts API'yi kullanın. Bir uzantının konuşma motoru uygulamasına olanak tanıyan ilgili ttsEngine API'ye de göz atın.

ttsEngine

Bir uzantı kullanarak metin okuma(TTS) motoru uygulamak için chrome.ttsEngine API'yi kullanın. Uzantınız bu API'yi kullanarak kaydolursa herhangi bir uzantı veya Chrome uygulaması konuşma oluşturmak için tts API'sini kullandığında, konuşulacak bir ifade ve diğer parametreleri içeren etkinlikler alır. Uzantınız daha sonra konuşmayı sentezlemek ve çıkışını yapmak için mevcut web teknolojilerini kullanabilir ve durumu bildirmek için etkinlikleri çağıran işleve geri gönderebilir.

types

chrome.types API, Chrome için tür bildirimlerini içerir.

userScripts
Chrome 120+ MV3+

Kullanıcı komut dosyalarını Kullanıcı Komut Dosyaları 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.

duvar kağıdı
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 uzaktan masaüstü yazılımının, Web Kimlik Doğrulama API'si (WebAuthn) isteklerini yerel bir istemcide işlemek için yakalamasına olanak tanır.

webNavigation

Devam eden gezinme isteklerinin durumuyla ilgili bildirim almak için chrome.webNavigation API'sini kullanın.

webRequest

Trafiği gözlemlemek ve analiz etmek, ayrıca devam eden istekleri engellemek, değiştirmek veya bunlara müdahale etmek için chrome.webRequest API'sini kullanın.

windows

Tarayıcı pencereleriyle etkileşimde bulunmak için chrome.windows API'sini kullanın. Bu API'yi kullanarak tarayıcıda pencereler oluşturabilir, bunları değiştirebilir ve yeniden düzenleyebilirsiniz.