chrome.debugger

Açıklama

chrome.debugger API, Chrome'un uzaktan hata ayıklama protokolü için alternatif bir aktarım işlevi görür. Ağ etkileşimini değerlendirmek, JavaScript'te hata ayıklamak, DOM ve CSS'yi değiştirmek vb. için bir veya daha fazla sekmeye ekleme yapmak üzere chrome.debugger kullanın.tabIdtabId

İzinler

debugger

Bu API'yi kullanmak için uzantınızın manifest dosyasında "debugger" iznini beyan etmeniz gerekir.

{
  "name": "My extension",
  ...
  "permissions": [
    "debugger",
  ],
  ...
}

Not

chrome.debugger API, güvenlik nedeniyle tüm Chrome Geliştirici Araçları Protokol Alan Adlarına erişim sağlamaz. Şu alanlar kullanılabilir: Accessibility, Audits, CacheStorage, Console, CSS, Veritabanı, Debugger, DOMDebugger, DOMDebugger, DOMDebugger Denetimler, CacheStorage, Console CSSWebAudioWebAuthn

Örnekler

Bu API'yi denemek için chrome-extension-samples deposundan debugger API örneğini yükleyin.

Türler

Debuggee

Hata ayıklama aracı tanımlayıcısı. tabId, extensionId veya targetId belirtilmelidir

Özellikler

  • extensionId

    string isteğe bağlı

    Hata ayıklamak istediğiniz uzantının kimliği. Uzantı arka plan sayfasına ekleme işlemi yalnızca --silent-debugger-extension-api komut satırı anahtarı kullanıldığında mümkündür.

  • tabId

    numara isteğe bağlı

    Hata ayıklamak istediğiniz sekmenin kimliği.

  • targetId

    string isteğe bağlı

    Hata ayıklama hedefinin opak kimliği.

DebuggerSession

Beklemede

Debugger oturum tanımlayıcısı. tabId, extensionsId veya targetId değerlerinden biri belirtilmelidir. Ayrıca, isteğe bağlı bir sessionId sağlanabilir. onEvent kaynağından gönderilen bağımsız değişkenler için sessionId belirtildiyse bu, etkinliğin kök hata ayıklama oturumundaki bir alt protokol oturumundan geldiği anlamına gelir. sessionId değeri sendCommand'e iletilirken belirtilirse kök hata ayıklama oturumundaki bir alt protokol oturumunu hedefler.

Özellikler

  • extensionId

    string isteğe bağlı

    Hata ayıklamak istediğiniz uzantının kimliği. Uzantı arka plan sayfasına ekleme işlemi yalnızca --silent-debugger-extension-api komut satırı anahtarı kullanıldığında mümkündür.

  • sessionId

    string isteğe bağlı

    Chrome Geliştirici Araçları Protokolü oturumunun opak kimliği. tabId, extensionId veya targetId tarafından tanımlanan kök oturumdaki bir alt oturum tanımlar.

  • tabId

    numara isteğe bağlı

    Hata ayıklamak istediğiniz sekmenin kimliği.

  • targetId

    string isteğe bağlı

    Hata ayıklama hedefinin opak kimliği.

DetachReason

Chrome 44 ve sonraki sürümler

Bağlantının feshi nedeni.

Enum

"target_closed"

"canceled_by_user"

TargetInfo

Hata ayıklama hedefi bilgileri

Özellikler

  • ekli

    boolean

    Hata ayıklayıcı zaten ekliyse doğru değerini alır.

  • extensionId

    string isteğe bağlı

    Tür = "background_page" ise tanımlanan uzantı kimliği.

  • faviconUrl

    string isteğe bağlı

    Site simgesinin URL'sini hedefleyin.

  • id

    dize

    Hedef kimliği.

  • tabId

    numara isteğe bağlı

    Tür == 'sayfa' ise tanımlanan sekme kimliği.

  • title

    dize

    Hedef sayfa başlığı.

  • Hedef türü.

  • url

    dize

    Hedef URL.

TargetInfoType

Chrome 44 ve sonraki sürümler

Hedef türü.

Enum

"background_page"

Yöntemler

attach()

Söz 
chrome.debugger.attach(
  target: Debuggee,
  requiredVersion: string,
  callback?: function,
)

Hata ayıklayıcıyı belirtilen hedefe ekler.

Parametreler

  • Eklemek istediğiniz hata ayıklama hedefi.

  • requiredVersion

    dize

    Gerekli hata ayıklama protokolü sürümü ("0.1"). Biri hata ayıklayıcıya yalnızca eşleşen ana sürüme ve daha büyük veya eşit bir alt sürüme sahip olabilir. Protokol sürümlerinin listesine buradan ulaşabilirsiniz.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

detach()

Söz 
chrome.debugger.detach(
  target: Debuggee,
  callback?: function,
)

Hata ayıklayıcıyı belirtilen hedeften ayırır.

Parametreler

  • Çıkarmak istediğiniz hedef hata ayıklama hedefi.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getTargets()

Söz 
chrome.debugger.getTargets(
  callback?: function,
)

Kullanılabilir hata ayıklama hedeflerinin listesini döndürür.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result: TargetInfo[])=>void

    • sonuç

      TargetInfo[]

      Kullanılabilir hata ayıklama hedeflerine karşılık gelen TargetInfo nesneleri dizisi.

İlerlemeler

  • Promise<TargetInfo[]>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

sendCommand()

Söz 
chrome.debugger.sendCommand(
  target: DebuggerSession,
  method: string,
  commandParams?: object,
  callback?: function,
)

Verilen komutu hata ayıklama hedefine gönderir.

Parametreler

  • Komutu göndermek istediğiniz hata ayıklama hedefi.

  • method

    dize

    Yöntem adı. Uzaktan hata ayıklama protokolü tarafından tanımlanan yöntemlerden biri olmalıdır.

  • commandParams

    isteğe bağlı

    İstek parametreleri içeren JSON nesnesi. Bu nesne, belirtilen yöntemin uzaktan hata ayıklama parametreleri şemasına uymalıdır.

  • geri çağırma

    Functions (isteğe bağlı)

    callback parametresi şu şekilde görünür: 

    (result?: object)=>void

    • sonuç

      isteğe bağlı

      Yanıt içeren JSON nesnesi. Yanıtın yapısı yöntem adına bağlı olarak değişir ve uzaktan hata ayıklama protokolündeki komut açıklamasının "returns" özelliği tarafından tanımlanır.

İlerlemeler

  • Promise<object|undefined>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onDetach

chrome.debugger.onDetach.addListener(
  callback: function,
)

Tarayıcı, sekme için hata ayıklama oturumunu sonlandırdığında tetiklenir. Bu durum, sekme kapatılırken veya eklenen sekme için Chrome Geliştirici Araçları çağrılırken meydana gelir.

Parametreler

onEvent

chrome.debugger.onEvent.addListener(
  callback: function,
)

Hedef sorunları araçları etkinliğinde hata ayıklandığında tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (source: DebuggerSession,method: string,params?: object)=>void