Console Utilities API referansı

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Console Utilities API, yaygın görevleri gerçekleştirme (ör. 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) için bir dizi kolaylık işlevi içerir.

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. Daha sonra, aynı değeri içeren $_ özelliği değerlendirilir:

$_ en son değerlendirilen ifadedir.

Sonraki örnekte, değerlendirilen ifade başlangıçta bir ad dizisi içeriyor. 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 öğesine (::before veya ::after gibi sözde öğeler dahil) ya da Profiller panelinde seçilen son beş JavaScript yığın nesnesine yönelik geçmiş referans olarak çalışır. $0 en son seçilen öğeyi veya JavaScript nesnesini, $1 en son seçilen ikinci öğeyi vb. döndürür.

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

Ö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 öğesine yapılan referansı döndürür. Tek bir bağımsız değişkenle çağrıldığında bu işlev, document.querySelector() işlevinin kısayoludur.

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 Nesneler panelinde göster'i veya sayfada göstermek için Görüntülemek için kaydır'ı seçin.

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

Ö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'dır.

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

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

$$(selector [, startNode])

$$(selector), verilen 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.

Tüm <code translate=Seçili düğümden sonra mevcut dokümanda görünen<img> öğeleri:

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

Belgedeki 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 kullanma örneği.

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şlevinde, öğelerin aranacağı bir öğeyi veya düğümü belirten isteğe bağlı ikinci bir parametre startNode bulunur.

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ı başlatılır ve Kaynaklar panelindeki işlevin içinde duraklatılır. Bu sayede kodda adım adım ilerleyip kodda hata ayıklayabilirsiniz.

debug(getData);

debug() ile bir işlevin içinde kesme.

İşlevde kesme işlemini durdurmak için undebug(fn) simgesini kullanın veya kullanıcı arayüzünü kullanarak tüm kesme noktalarını devre dışı bırakın.

Kesme noktaları hakkında daha fazla bilgi için Pause Your Code With Breakpoints (Kesme noktalarıyla kodunuzu duraklatma) başlıklı makaleyi inceleyin.

dir(object)

dir(object), belirtilen nesnenin tüm özelliklerinin nesne stili listesini gösterir. Bu yöntem, Console API'nin console.dir() yöntemi için bir kısayoldur.

Aşağıdaki örnekte, document.body öğesinin doğrudan komut satırında değerlendirilmesi ile aynı öğeyi görüntülemek için dir() kullanılması 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), Öğeler panelinde görüldüğü gibi, belirtilen nesnenin XML gösterimini yazdırır. Bu yöntem, console.dirxml() yöntemine eşdeğerdir.

inspect(object/function)

inspect(object/function), uygun panelde belirtilen öğeyi veya nesneyi 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);

Bir öğeyi inspect() ile inceleme.

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

getEventListeners(object)

getEventListeners(object), belirtilen nesneye kayıtlı etkinlik işleyicileri döndürür. Dönüş değeri, her kayıtlı etkinlik türü için bir dizi içeren bir nesnedir (ör. click veya keydown). Her dizinin üyeleri, her tür için kayıtlı dinleyiciyi açıklayan nesnelerdir. Örneğin, aşağıda document nesnesine kaydedilen tüm etkinlik işleyiciler listelenmiştir:

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öntemlerinin örneği.

monitor(işlev)

Belirtilen işlev çağrıldığında, konsola işlev adını ve çağrıldığında işleve iletilen bağımsız değişkenleri gösteren 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, Event nesnesi konsola kaydedilir. İzlenecek tek bir etkinlik, bir etkinlik dizisi veya önceden tanımlanmış bir etkinlik koleksiyonuyla eşlenmiş 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");

İzleme penceresi yeniden boyutlandırma etkinlikleri.

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ılabilen 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ğıda Öğeler panelinde şu anda seçili olan bir giriş metni alanındaki tüm ilgili önemli etkinlikler için "key" etkinlik türü kullanılmaktadı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 parçada gösterir.

Profil oluşturmaya başlamak için:

profile("Profile 1")

Profillendirmeyi durdurmak ve sonuçları Performans > Ana izinde görmek için:

profileEnd("Profile 1")

Performans > Ana parçada 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 nesneler 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 şu anda seçili olan yürütme bağlamıdır.

table(data [, columns])

İsteğe bağlı sütun başlıklarıyla birlikte bir veri nesnesi ileterek nesne verilerini tablo biçimlendirmesiyle günlüğe kaydedin. 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önteminin örneği.

Günlüğe kaydedilmiş bir tabloyu biçimlendirilmiş Markdown tablosu veya CSV verileri olarak panonuza kopyalamak için Konsol'daki 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);

Ayrıca, bir nesnedeki belirli etkinliklerin izlenmesini seçerek 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).