API referansı

Çoğu uzantının çalışması için bir veya daha fazla Chrome Extensions API'sine erişmesi gerekir. Bu API referansında, kullanılabilecek API'ler açıklanmaktadır kullanım örneklerine yer verir.

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 gönderin. Birçok API, manifest dosyasında da izinleri gerektirir.

Uzantı API'lerindeki yöntemler, aksi belirtilmedikçe eşzamansız olur. Eşzamansız yöntemler beklemeden, anında geri döner . Bu yöntemlerin sonuçlarını almak için vaatleri kullanın. Daha fazla bilgi için Eşzamansız yöntemler bölümüne bakın.

Chrome Uzantı API'leri

accessibilityFeatures

Chrome'un erişilebilirlik özelliklerini yönetmek için chrome.accessibilityFeatures API'yi kullanın. Bu API, bağımsız erişilebilirlik özelliklerini almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır. Özellik durumlarını almak için uzantının accessibilityFeatures.read izni istemesi gerekir. Özellik durumunu değiştirmek için uzantının accessibilityFeatures.modify iznine ihtiyacı var. accessibilityFeatures.modify işlevinin accessibilityFeatures.read iznini ima etmediğini unutmayın.

işlem
Chrome 88 ve sonraki sürümler MV3+

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

alarmlar

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 edinmelerine ve bu cihazları kontrol etmelerine olanak tanımak için sağlanmaktadır. Bu API şu anda yalnızca ChromeOS için kiosk modunda kullanılabilir.

yer işaretleri

Yer işaretlerini oluşturmak, düzenlemek ve diğer amaçlarla değiştirmek için chrome.bookmarks API'sini 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 (ör. tarayıcı işlemini açma işlemi veya uzantıya komut gönderme) tetikleyen klavye kısayolları eklemek için Komutlar API'sini kullanın.

contentSettings

Web sitelerinin çerezler, JavaScript ve eklentiler gibi özellikleri kullanıp kullanamayacağını kontrol eden ayarları değiştirmek için chrome.contentSettings API'sini 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.

çerez

Çerezleri sorgulamak, değiştirmek ve değişiklik yapıldığında bildirim almak için chrome.cookies API'yi kullanın.

hata ayıklayıcı

chrome.debugger API'si, Chrome'un uzaktan hata ayıklama protokolü için alternatif bir aktarım görevi görü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. sendCommand içeren sekmeleri hedeflemek ve etkinlikleri onEvent geri çağırmalarından tabId tarihine göre yönlendirmek için Debuggee özelliğini tabId 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 'nı inceleyin.

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 müdahale etmeden ve içeriklerini görüntülemeden değiştirerek daha fazla gizlilik sağlar.

desktopCapture

Desktop Capture API ekranın içeriğini, tek tek pencereleri veya tek tek sekmeleri yakalar.

devtools.inspectedWindow

Denetlenen pencereyle etkileşim kurmak için chrome.devtools.inspectedWindow API'sini kullanın: İncelenen sayfanın sekme kimliğini alın, kodu denetlenen 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

Uzantınızı Geliştirici Araçları pencere kullanıcı arayüzüne entegre etmek için chrome.devtools.panels API'sini kullanın: Kendi panellerinizi oluşturun, mevcut panellere erişin ve kenar çubukları ekleyin.

devtools.performance
Beklemede

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 sonraki sürümler 'nı inceleyin.

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

dns
Yeni geliştirilenler kanalı 'nı inceleyin.

DNS çözünürlüğü için chrome.dns API'yi kullanın.

documentScan
Chrome 44 ve sonraki sürümler Yalnızca ChromeOS

Ekli belge tarayıcılardan resim keşfetmek ve almak için chrome.documentScan API'yi kullanın.

dom
Chrome 88 ve sonraki sürümler 'nı inceleyin.

Uzantılar için özel DOM API'lerine erişmek üzere chrome.dom API'yi kullanın

indirme sayısı

İ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 'nı inceleyin. 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

chrome.enterprise.platformKeys API'yi kullanarak bu anahtarlar için anahtar oluşturun ve sertifikaları yükleyin. Sertifikalar platform tarafından yönetilir ve TLS kimlik doğrulaması, ağ erişimi veya chrome.platformKeys aracılığıyla başka bir uzantı tarafından kullanılabilir.

etkinlikler

chrome.events ad alanı, ilginç bir şey olduğunda sizi bilgilendirmek için etkinlik gönderen API'lerin kullandığı yaygın türleri içerir.

uzantı

chrome.extension API, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar içerir. Bu araç, İleti Aktarma bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile onun içerik komut dosyaları veya uzantılar arasında mesaj alışverişinde bulunma desteği 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ükleyebilmesini sağlamak için bu API'yi kullanabilirsiniz.

fileSystemProvider
Yalnızca ChromeOS 'nı inceleyin.

Chrome OS'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'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.

geçmiş

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 konusuna 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.

kimlik

OAuth2 erişim jetonları almak için chrome.identity API'yi kullanın.

boşta

Makinenin boşta kalma durumunun ne zaman değiştiğini algılamak için chrome.idle API'yi kullanın.

input.ime
Yalnızca ChromeOS 'nı inceleyin.

Chrome OS için özel bir IME uygulamak üzere chrome.input.ime API'yi kullanın. Bu, uzantınızın tuş vuruşlarını işlemesine, besteyi ayarlamasına ve aday pencereyi yönetmesine olanak tanır.

instanceID
Chrome 44 ve sonraki sürümler 'nı inceleyin.

Ö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ı sunar.

bildirimler

Ş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.

çok amaçlı adres çubuğu

Ç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 anında değil, çalışma zamanında istemek için chrome.permissions API'yi kullanın. Böylece, kullanıcılar izinlerin neden gerekli olduğunu anlar ve yalnızca gerekli izinleri verir.

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'yi kullanın. Kullanıcı veya politika izin verirse bir uzantı, özel kimlik doğrulama protokolünde böyle bir sertifikayı 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).

güç

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 'nı inceleyin.

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

yazdırma
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

Yazdırma kullanımıyla ilgili verileri getirmek 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şlemleriyle etkileşimde bulunmak 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+

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 sonraki sürümler MV3+

İçeriği, bir web sayfasının ana içeriğinin yanı sıra tarayıcının yan panelinde barındırmak için chrome.sidePanel API'sini kullanın.

depolama alanı

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ılardan 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 gruplama sistemiyle etkileşimde bulunmak için chrome.tabGroups API'sini kullanın. Bu API'yi, tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için 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ının sekme sistemiyle etkileşimde bulunmak 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örüntülenen en popüler sitelere (yani 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) çalmak için chrome.tts API'yi kullanın. Ayrıca, uzantıların konuşma motoru uygulamasına izin veren ilgili ttsEngine API'sine de bakı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 kaydoluyorsa, herhangi bir uzantı veya Chrome uygulaması konuşma oluşturmak için tts API'yi kullandığında, söylenecek bir sözü ve diğer parametreleri içeren etkinlikler alır. Böylece uzantınız konuşmayı sentezlemek ve çıktısını almak için mevcut herhangi bir web teknolojisini kullanabilir ve durumu bildirmek için etkinlikleri çağrı işlevine 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ı 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

Bir VPN istemcisini 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 ve sonraki sürümler MV3+

chrome.webAuthenticationProxy API, uzak ana makine üzerinde çalışan uzaktan masaüstü yazılımının, yerel bir istemcide işlemek üzere Web Authentication API (WebAuthn) isteklerine 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 pencereler oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz.