Console Utilities API referansı

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Console Utilities API, yaygın görevleri gerçekleştirmek için kullanışlı işlevler içerir: DOM öğelerini seçme ve inceleme, nesneleri sorgulama, verileri okunabilir biçimde görüntüleme, profil oluşturucuyu durdurma ve başlatma, DOM etkinliklerini ve işlev çağrılarını izleme ve daha fazlası.

console.log(), console.error() ve diğer console.* işlevlerini mi arıyorsunuz? Console API referansı bölümüne bakın.

$_

$_, en son değerlendirilen ifadenin değerini döndürür.

Aşağıdaki örnekte basit bir ifade (2 + 2) değerlendirilmektedir. Ardından, aynı değeri içeren $_ özelliği değerlendirilir:

$_ en son değerlendirilen ifadedir.

Bir sonraki örnekte, değerlendirilen ifade başlangıçta bir ad dizisi içerir. Dizinin uzunluğunu bulmak için $_.length değerlendirilirken $_ içinde depolanan değer, değerlendirilen son ifade olan 4 olarak değişir:

$_ yeni komutlar değerlendirildiğinde değişir.

0 - 4 ABD doları

$0, $1, $2, $3 ve $4 komutları, Öğeler panelinde incelenen son beş DOM öğesi (::before veya ::after gibi sözde öğeler dahil) ya da Profiller panelinde seçilen son beş JavaScript yığın nesnesi için geçmiş referansı olarak çalışır. $0 en son seçilen öğeyi veya JavaScript nesnesini, $1 ise en son seçilen ikinci öğeyi döndürür.

Aşağıdaki örnekte, Öğeler panelinde bir img öğesi seçilmiştir. Konsol çekmecesinde $0 değerlendirilir ve aynı öğeyi gösterir:

Örnek: 0 ABD doları.

Aşağıdaki resimde aynı sayfada seçilen farklı bir öğe gösterilmektedir. $0 artık yeni seçilen öğeyi ifade ederken $1 daha önce seçilen öğeyi döndürür:

1 ABD doları örneği.

$(selector [, startNode])

$(selector), belirtilen CSS seçiciye sahip ilk DOM öğesinin referansını döndürür. Tek bir bağımsız değişkenle çağrıldığında bu işlev, document.querySelector() işlevi için bir kısayoldur.

Aşağıdaki örnek, dokümandaki ilk <img> öğesine bir referans döndürür:

$('img') örneği.

Döndürülen sonucu sağ tıklayın ve DOM'da bulmak için Öğeler Panelinde Göster'i veya sayfada göstermek için Görünümde Kaydır'ı seçin.

Aşağıdaki örnek, seçili öğeye bir referans döndürür ve öğenin src özelliğini gösterir:

Örnek: $('img').src.

Bu işlev, öğelerin aranacağı bir "öğe" veya düğüm belirten ikinci bir parametreyi (startNode) de destekler. Bu parametrenin varsayılan değeri document şeklindedir.

Aşağıdaki örnek, devsite-header-background öğesinin alt öğesi olan ilk img öğesine bir referans döndürür ve bu öğenin src özelliğini gösterir:

Örnek: $('img', div).src.

$$(selector [, startNode])

$$(seçici), belirtilen CSS seçiciyle eşleşen bir öğe dizisi döndürür. Bu komut, Array.from(document.querySelectorAll()) komutunu çağırmakla eşdeğerdir.

Aşağıdaki örnekte $$() to create an array of all <img> elements in the current document and displays the value of each element's src property:

let images = $$('img');
for (let each of images) {
  console.log(each.src);
}
 kullanılmaktadır.

Seçili düğümden sonra geçerli dokümanda görünen Tüm<code translate=<!-- notranslate l10n-placeholder: l10n-placeholder3 -->()</code > kod çevirisi örneğiyle bir dizi oluşturma<img> öğeleri:

let images = $$('img', document.querySelector('.devsite-header-background'));
for (let each of images) {
  console.log(each.src);
}

Dokümandaki seçili div öğesinden sonra görünen tüm resimleri seçmek ve kaynaklarını görüntülemek için $() kullanımına örnek.

$x(path [, startNode])

$x(path), belirtilen XPath ifadesiyle eşleşen DOM öğelerinden oluşan bir dizi döndürür.

Örneğin, aşağıdaki kod, sayfadaki tüm <p> öğelerini döndürür:

$x("//p")

XPath seçici kullanımına örnek.

Aşağıdaki örnekte, <a> öğelerini içeren tüm <p> öğeleri döndürülür:

$x("//p[a]")

Daha karmaşık bir XPath seçici kullanma örneği.

Diğer seçici işlevlerine benzer şekilde, $x(path) işlevinin de öğelerin aranacağı bir öğeyi veya düğümü belirten isteğe bağlı ikinci bir parametresi (startNode) vardır.

startNode ile XPath seçici kullanma örneği.

clear()

clear(), konsolun geçmişini temizler.

clear();

copy(object)

copy(object), belirtilen nesnenin dize temsilini panoya kopyalar.

copy($0);

debug(function)

Belirtilen işlev çağrıldığında hata ayıklayıcı çağrılır ve Kaynaklar panelindeki işlevin içinde kesme noktası oluşturarak kodda adım adım ilerlemenize ve hata ayıklamanıza olanak tanır.

debug(getData);

debug() ile bir işlevin içinde kesme noktası oluşturma.

İşlevde kesme noktası eklemeyi durdurmak için undebug(fn) komutunu kullanın veya tüm kesme noktalarını devre dışı bırakmak için kullanıcı arayüzünü kullanın.

Kesme noktaları hakkında daha fazla bilgi için Kodunuzu Kesme Noktalarıyla Duraklatma başlıklı makaleyi inceleyin.

dir(object)

dir(object), belirtilen nesnenin tüm özelliklerini nesne stilinde listeler. Bu yöntem, Console API'nin console.dir() yönteminin kısayoludur.

Aşağıdaki örnekte, document.body ifadesini doğrudan komut satırında değerlendirmek ile aynı öğeyi görüntülemek için dir() kullanmak arasındaki fark gösterilmektedir:

document.body;
dir(document.body);

document.body'yi dir() işleviyle ve bu işlev olmadan günlüğe kaydetme

Daha fazla bilgi için Console API'deki console.dir() girişine bakın.

dirxml(object)

dirxml(object), belirtilen nesnenin XML temsilini Öğeler panelinde görüldüğü gibi yazdırır. Bu yöntem, console.dirxml() yöntemine eşdeğerdir.

inspect(object/function)

inspect(object/function), belirtilen öğeyi veya nesneyi uygun panelde açar ve seçer: DOM öğeleri için Öğeler paneli veya JavaScript yığın nesneleri için Profiller paneli.

Aşağıdaki örnekte, Öğeler panelinde document.body açılır:

inspect(document.body);

inspect() ile bir öğeyi inceleme

İncelenecek bir işlev ilettiğinizde işlev, dokümanı incelemeniz için Kaynaklar panelinde açar.

getAccessibleName(node)

getAccessibleName(node), belirtilen DOM düğümünün hesaplanan erişilebilir özellikli adını döndürür. Bu, ekran okuyucular gibi yardımcı teknolojilerin öğe için duyurduğu addır. Örneğin, Öğeler panelinde bir düğmeyi inceleyin ve ardından şunu çalıştırın:

getAccessibleName($0);

getAccessibleRole(node)

getAccessibleRole(node), belirtilen DOM düğümünün hesaplanan erişilebilirlik rolünü (ör. 'button', 'link' veya 'heading') döndürür. Örneğin, Öğeler panelinde bir öğeyi inceleyin ve ardından şunu çalıştırın:

getAccessibleRole($0);

getEventListeners(object)

getEventListeners(object), belirtilen nesneye kayıtlı etkinlik işleyicileri döndürür. Döndürülen değer, kayıtlı her etkinlik türü (ör. click veya keydown) için bir dizi içeren bir nesnedir. Her dizinin üyeleri, her tür için kayıtlı dinleyiciyi açıklayan nesnelerdir. Örneğin, aşağıdaki kod, document nesnesinde kayıtlı tüm etkinlik işleyicileri listeler:

getEventListeners(document);

getEventListeners() kullanmanın çıkışı.

Belirtilen nesneye birden fazla dinleyici kaydedilmişse dizi, her dinleyici için bir üye içerir. Aşağıdaki örnekte, click etkinliği için belge öğesinde kayıtlı iki etkinlik işleyici vardır:

Birden fazla dinleyici.

Özelliklerini keşfetmek için bu nesnelerin her birini daha da genişletebilirsiniz:

Dinleyici nesnesinin genişletilmiş görünümü.

Daha fazla bilgi için Nesne özelliklerini inceleme başlıklı makaleyi inceleyin.

keys(object)

keys(object), belirtilen nesneye ait özelliklerin adlarını içeren bir dizi döndürür. Aynı özelliklerin ilişkili değerlerini almak için values() yöntemini kullanın.

Örneğin, uygulamanızın aşağıdaki nesneyi tanımladığını varsayalım:

let player = {
    "name": "Parzival",
    "number": 1,
    "state": "ready",
    "easterEggs": 3
};

player öğesinin global ad alanında tanımlandığını varsayarsak (basitlik açısından) Konsol'da keys(player) ve values(player) yazıldığında aşağıdaki sonuç elde edilir:

keys() ve values() yöntemlerine örnek.

monitor(function)

Belirtilen işlev çağrıldığında, konsola işlev adını ve işlev çağrıldığında işleve iletilen bağımsız değişkenleri belirten bir mesaj kaydedilir.

function sum(x, y) {
  return x + y;
}
monitor(sum);

monitor() yöntemi örneği.

İzlemeyi durdurmak için unmonitor(function) tuşlarına basın.

monitorEvents(object [, events])

Belirtilen nesnede belirtilen etkinliklerden biri gerçekleştiğinde, olay nesnesi konsola kaydedilir. İzlenecek tek bir etkinlik, bir etkinlik dizisi veya önceden tanımlanmış bir etkinlik koleksiyonuyla eşlenen genel etkinlik "türlerinden" birini belirtebilirsiniz. Aşağıdaki örneklere bakın.

Aşağıdaki kod, pencere nesnesindeki tüm yeniden boyutlandırma etkinliklerini izler.

monitorEvents(window, "resize");

Pencere yeniden boyutlandırma etkinliklerini izleme.

Aşağıda, pencere nesnesindeki hem "resize" hem de "scroll" etkinliklerini izlemek için bir dizi tanımlanmıştır:

monitorEvents(window, ["resize", "scroll"])

Ayrıca, önceden tanımlanmış etkinlik gruplarıyla eşlenen dizeler olan mevcut etkinlik "türlerinden" birini de belirtebilirsiniz. Aşağıdaki tabloda, kullanılabilir etkinlik türleri ve bunlarla ilişkili etkinlik eşlemeleri listelenmiştir:

Etkinlik türü ve karşılık gelen eşlenmiş etkinlikler
fare"mousedown", "mouseup", "click", "dblclick", "mousemove", "mouseover", "mouseout", "mousewheel"
anahtar"keydown", "keyup", "keypress", "textInput"
dokun"touchstart", "touchmove", "touchend", "touchcancel"
kontrol"resize", "scroll", "zoom", "focus", "blur", "select", "change", "submit", "reset"

Örneğin, aşağıdaki örnekte, Öğeler panelinde seçili olan bir giriş metni alanındaki tüm ilgili tuş etkinlikleri için "tuş" etkinlik türü kullanılır.

monitorEvents($0, "key");

Metin alanına karakter yazıldıktan sonraki örnek çıkış aşağıda verilmiştir:

Önemli etkinlikleri izleme

İzlemeyi durdurmak için unmonitorEvents(object[, events]) tuşlarına basın.

profile([name]) ve profileEnd([name])

profile(), isteğe bağlı bir adla JavaScript CPU profili oluşturma oturumu başlatır. profileEnd() profili tamamlar, Performans panelini otomatik olarak açar ve sonuçları Ana kanalda gösterir.

Profil oluşturmaya başlamak için:

profile("Profile 1")

Profil oluşturmayı durdurmak ve sonuçları Performans > Ana kanalında görmek için:

profileEnd("Profile 1")

Performans > Ana kanalındaki sonuç:

Performans'ın ana kanalındaki 1. profil.

Profiller iç içe de yerleştirilebilir. Örneğin, aşağıdaki komutlar herhangi bir sırayla çalışır:

profile('A');
profile('B');
profileEnd('A');
profileEnd('B');

queryObjects(Constructor)

Belirtilen oluşturucuyla oluşturulan nesnelerin dizisini döndürmek için konsoldan queryObjects(Constructor) işlevini çağırın. Örneğin:

  • queryObjects(Promise). Promise dizesinin tüm örneklerini döndürür.
  • queryObjects(HTMLElement). Tüm HTML öğelerini döndürür.
  • queryObjects(foo) (foo, sınıf adıdır). new foo() aracılığıyla örneklendirilen tüm nesneleri döndürür.

queryObjects() kapsamı, konsolda seçili olan yürütme bağlamıdır.

table(data [, columns])

İsteğe bağlı sütun başlıkları içeren bir veri nesnesi ileterek nesne verilerini tablo biçimlendirmesiyle günlüğe kaydeder. Bu, console.table() için bir kısayoldur.

Örneğin, konsoldaki bir tabloyu kullanarak ad listesi görüntülemek için şunları yaparsınız:

let names = [
  { firstName: "John", lastName: "Smith" },
  { firstName: "Jane", lastName: "Doe" },
];
table(names);

table() yöntemine örnek.

Günlüğe kaydedilen bir tabloyu biçimlendirilmiş Markdown tablosu veya CSV verisi olarak panonuza kopyalamak için Konsol'da tabloyu sağ tıklayın ve bağlam menüsünden ilgili kopyalama seçeneğini belirleyin.

undebug(function)

undebug(function), belirtilen işlevin hata ayıklamasını durdurur. Böylece, işlev çağrıldığında hata ayıklayıcı artık çağrılmaz. Bu, debug(fn) ile birlikte kullanılır.

undebug(getData);

unmonitor(function)

unmonitor(function), belirtilen işlevin izlenmesini durdurur. Bu, monitor(fn) ile birlikte kullanılır.

unmonitor(getData);

unmonitorEvents(object [, events])

unmonitorEvents(object[, events]), belirtilen nesne ve etkinlikler için etkinlikleri izlemeyi durdurur. Örneğin, aşağıdaki kod pencere nesnesindeki tüm etkinlik izlemeyi durdurur:

unmonitorEvents(window);

Bir nesnedeki belirli etkinlikleri izlemeyi de durdurabilirsiniz. Örneğin, aşağıdaki kod, seçili öğedeki tüm fare etkinliklerini izlemeye başlar ve ardından "mousemove" etkinliklerini izlemeyi durdurur (konsol çıkışındaki gürültüyü azaltmak için):

monitorEvents($0, "mouse");
unmonitorEvents($0, "mousemove");

values(object)

values(object), belirtilen nesneye ait tüm özelliklerin değerlerini içeren bir dizi döndürür.

let player = {
    "name": "Parzival",
    "number": 1,
    "state": "ready",
    "easterEggs": 3
};

values(player);

Değerlerin sonucu (oyuncu).