Console Utilities API 참조

Sofia Emelianova
Sofia Emelianova

Console Utilities API에는 DOM 요소 선택 및 검사, 객체 쿼리, 읽기 쉬운 형식으로 데이터 표시, 프로파일러 중지 및 시작, DOM 이벤트 및 함수 호출 모니터링 등의 일반적인 작업을 실행하기 위한 편의 함수 모음이 포함되어 있습니다.

console.log(), console.error(), 나머지 console.* 함수를 찾고 계신가요? Console API 참조를 참고하세요.

$_

$_는 가장 최근에 평가된 표현식의 값을 반환합니다.

다음 예에서는 간단한 표현식 (2 + 2)이 평가됩니다. 그러면 동일한 값을 포함하는 $_ 속성이 평가됩니다.

$_는 가장 최근에 평가된 표현식입니다.

다음 예에서 평가된 표현식에는 처음에 이름 배열이 포함됩니다. $_.length를 평가하여 배열의 길이를 찾으면 $_에 저장된 값이 변경되어 최근 평가된 표현식 4가 됩니다.

$_는 새 명령어가 평가될 때 변경됩니다.

$0 - $4

$0, $1, $2, $3, $4 명령어는 요소 패널 내에서 검사된 마지막 5개의 DOM 요소 또는 프로필 패널에서 선택된 마지막 5개의 JavaScript 힙 객체에 대한 이전 참조로 작동합니다. $0는 가장 최근에 선택된 요소 또는 JavaScript 객체를 반환하고 $1는 두 번째로 최근에 선택된 요소를 반환하는 식입니다.

다음 예에서는 요소 패널에서 img 요소가 선택되어 있습니다. 콘솔 창에서 $0가 평가되었으며 동일한 요소가 표시됩니다.

예: 0달러

아래 이미지는 동일한 페이지에서 선택된 다른 요소를 보여줍니다. 이제 $0는 새로 선택된 요소를 참조하고 $1는 이전에 선택된 요소를 반환합니다.

$1의 예

$(selector [, startNode])

$(selector)는 지정된 CSS 선택기가 있는 첫 번째 DOM 요소에 대한 참조를 반환합니다. 인수가 하나인 경우 이 함수는 document.querySelector() 함수의 바로가기입니다.

다음 예에서는 문서의 첫 번째 <img> 요소에 대한 참조를 반환합니다.

$(&#39;img&#39;)의 예

반환된 결과를 마우스 오른쪽 버튼으로 클릭하고 요소 패널에 표시를 선택하여 DOM에서 찾거나 스크롤하여 보기를 선택하여 페이지에 표시합니다.

다음 예에서는 현재 선택된 요소의 참조를 반환하고 src 속성을 표시합니다.

$(&#39;img&#39;).src의 예

이 함수는 요소를 검색할 '요소' 또는 노드를 지정하는 두 번째 매개변수 startNode도 지원합니다. 이 매개변수의 기본값은 document입니다.

다음 예에서는 devsite-header-background의 자손인 첫 번째 img 요소에 대한 참조를 반환하고 src 속성을 표시합니다.

$(&#39;img&#39;, div).src의 예

$$(selector [, startNode])

$$(선택자)는 지정된 CSS 선택자와 일치하는 요소의 배열을 반환합니다. 이 명령어는 Array.from(document.querySelectorAll())를 호출하는 것과 같습니다.

다음 예에서는 $$() 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);
}
를 사용합니다.

<!-- notranslate l10n-placeholder: l10n-placeholder3 -->()</code>를 사용하여 모든 <code translate=선택한 노드 뒤에 현재 문서에 표시되는<img> 요소:

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

$()를 사용하여 문서의 select div 요소 뒤에 표시되는 모든 이미지를 선택하고 소스를 표시하는 예시입니다.

$x(path [, startNode])

$x(path)는 지정된 XPath 표현식과 일치하는 DOM 요소의 배열을 반환합니다.

예를 들어 다음은 페이지의 모든 <p> 요소를 반환합니다.

$x("//p")

XPath 선택기를 사용하는 예시

다음 예에서는 <a> 요소가 포함된 모든 <p> 요소를 반환합니다.

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

더 복잡한 XPath 선택기를 사용하는 예시

다른 선택기 함수와 마찬가지로 $x(path)에는 요소를 검색할 요소 또는 노드를 지정하는 선택적 두 번째 매개변수 startNode가 있습니다.

startNode와 함께 XPath 선택기를 사용하는 예

clear()

clear(): 콘솔의 기록을 삭제합니다.

clear();

copy(객체)

copy(object)는 지정된 객체의 문자열 표현을 클립보드에 복사합니다.

copy($0);

debug(function)

지정된 함수가 호출되면 디버거가 호출되고 소스 패널의 함수 내에서 중단되어 코드를 단계별로 실행하고 디버그할 수 있습니다.

debug(getData);

debug()를 사용하여 함수 내에서 중단

undebug(fn)를 사용하여 함수에서 중단을 중지하거나 UI를 사용하여 모든 중단점을 사용 중지합니다.

브레이크포인트에 관한 자세한 내용은 브레이크포인트로 코드 일시중지를 참고하세요.

dir(객체)

dir(object)는 지정된 모든 객체의 속성 목록을 객체 스타일로 표시합니다. 이 메서드는 Console API의 console.dir() 메서드에 대한 바로가기입니다.

다음 예는 명령줄에서 document.body를 직접 평가하는 것과 dir()를 사용하여 동일한 요소를 표시하는 것의 차이를 보여줍니다.

document.body;
dir(document.body);

dir() 함수 유무와 관계없이 document.body를 로깅합니다.

자세한 내용은 Console API의 console.dir() 항목을 참고하세요.

dirxml(객체)

dirxml(object)요소 패널에 표시된 대로 지정된 객체의 XML 표현을 출력합니다. 이 메서드는 console.dirxml() 메서드와 동일합니다.

inspect(객체/함수)

inspect(object/function): 지정된 요소 또는 객체를 열고 적절한 패널(DOM 요소의 경우 요소 패널, JavaScript 힙 객체의 경우 프로필 패널)에서 선택합니다.

다음 예에서는 요소 패널에서 document.body를 엽니다.

inspect(document.body);

inspect()를 사용하여 요소 검사

검사할 함수를 전달하면 함수가 소스 패널에서 문서를 열어 검사할 수 있도록 합니다.

getEventListeners(object)

getEventListeners(object)는 지정된 객체에 등록된 이벤트 리스너를 반환합니다. 반환 값은 등록된 각 이벤트 유형 (예: click 또는 keydown)의 배열이 포함된 객체입니다. 각 배열의 구성원은 각 유형에 등록된 리스너를 설명하는 객체입니다. 예를 들어 다음은 문서 객체에 등록된 모든 이벤트 리스너를 나열합니다.

getEventListeners(document);

getEventListeners() 사용의 출력입니다.

지정된 객체에 등록된 리스너가 두 개 이상인 경우 배열에는 각 리스너의 멤버가 포함됩니다. 다음 예에서는 click 이벤트의 문서 요소에 등록된 두 개의 이벤트 리스너가 있습니다.

여러 리스너

이러한 각 객체를 펼쳐 속성을 살펴볼 수 있습니다.

리스너 객체의 확장된 뷰

자세한 내용은 객체 속성 검사를 참고하세요.

keys(객체)

keys(object)는 지정된 객체에 속한 속성의 이름이 포함된 배열을 반환합니다. 동일한 속성의 연결된 값을 가져오려면 values()를 사용하세요.

예를 들어 애플리케이션에서 다음 객체를 정의했다고 가정해 보겠습니다.

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

편의상 player가 글로벌 네임스페이스에 정의되었다고 가정하면 콘솔keys(player)values(player)를 입력하면 다음과 같은 결과가 표시됩니다.

keys() 및 values() 메서드의 예

monitor(함수)

지정된 함수가 호출되면 함수가 호출될 때 함수에 전달된 인수와 함께 함수 이름을 나타내는 메시지가 콘솔에 로깅됩니다.

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

monitor() 메서드의 예

unmonitor(function)를 사용하여 모니터링을 중지합니다.

monitorEvents(object [, events])

지정된 객체에서 지정된 이벤트 중 하나가 발생하면 이벤트 객체가 콘솔에 로깅됩니다. 모니터링할 단일 이벤트, 이벤트 배열 또는 사전 정의된 이벤트 모음에 매핑된 일반 이벤트 '유형' 중 하나를 지정할 수 있습니다. 아래 예를 참조하세요.

다음은 창 객체의 모든 크기 조절 이벤트를 모니터링합니다.

monitorEvents(window, "resize");

창 크기 조절 이벤트 모니터링

다음은 window 객체에서 'resize' 및 'scroll' 이벤트를 모두 모니터링하는 배열을 정의합니다.

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

사전 정의된 이벤트 세트에 매핑되는 문자열인 사용 가능한 이벤트 '유형' 중 하나를 지정할 수도 있습니다. 다음 표에는 사용 가능한 이벤트 유형과 관련 이벤트 매핑이 나와 있습니다.

이벤트 유형 및 해당 매핑된 이벤트
'mousedown', 'mouseup', 'click', 'dblclick', 'mousemove', 'mouseover', 'mouseout', 'mousewheel'
'keydown', 'keyup', 'keypress', 'textInput'
터치'touchstart', 'touchmove', 'touchend', 'touchcancel'
제어'크기 조절', '스크롤', '확대/축소', '포커스', '흐리게 처리', '선택', '변경', '제출', '재설정'

예를 들어 다음은 요소 패널에서 현재 선택된 입력 텍스트 필드의 모든 해당 키 이벤트에 '키' 이벤트 유형을 사용합니다.

monitorEvents($0, "key");

다음은 텍스트 필드에 문자를 입력한 후의 샘플 출력입니다.

주요 이벤트 모니터링

unmonitorEvents(object[, events])를 사용하여 모니터링을 중지합니다.

profile([name]) 및 profileEnd([name])

profile(): 이름(선택사항)을 사용하여 JavaScript CPU 프로파일링 세션을 시작합니다. profileEnd()는 프로필을 완성하고 성능 > 기본 트랙에 결과를 표시합니다.

프로파일링을 시작하려면 다음 단계를 따르세요.

profile("Profile 1")

프로파일링을 중지하고 성능 > 기본 트랙에서 결과를 보려면 다음 단계를 따르세요.

profileEnd("Profile 1")

실적 > 기본 트랙의 결과:

실적의 기본 트랙에 있는 프로필 1

프로필을 중첩할 수도 있습니다. 예를 들어 다음과 같은 순서라면 상관없습니다.

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

queryObjects(Constructor)

콘솔에서 queryObjects(Constructor)를 호출하여 지정된 생성자로 만든 객체 배열을 반환합니다. 예를 들면 다음과 같습니다.

  • queryObjects(Promise). Promise의 모든 인스턴스를 반환합니다.
  • queryObjects(HTMLElement). 모든 HTML 요소를 반환합니다.
  • queryObjects(foo): 여기서 foo은 클래스 이름입니다. new foo()를 통해 인스턴스화된 모든 객체를 반환합니다.

queryObjects()의 범위는 콘솔에서 현재 선택된 실행 컨텍스트입니다.

table(data [, columns])

선택적 열 헤더와 함께 데이터 객체를 전달하여 테이블 형식으로 객체 데이터를 로깅합니다. console.table()의 단축키입니다.

예를 들어 콘솔에서 테이블을 사용하여 이름 목록을 표시하려면 다음을 실행합니다.

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

table() 메서드의 예

undebug(함수)

undebug(function)는 지정된 함수의 디버깅을 중지하여 함수가 호출될 때 디버거가 더 이상 호출되지 않도록 합니다. debug(fn)와 함께 사용됩니다.

undebug(getData);

unmonitor(함수)

unmonitor(function)는 지정된 함수의 모니터링을 중지합니다. monitor(fn)와 함께 사용됩니다.

unmonitor(getData);

unmonitorEvents(object [, events])

unmonitorEvents(object[, events])는 지정된 객체 및 이벤트에 대한 이벤트 모니터링을 중지합니다. 예를 들어 다음은 창 객체에서 모든 이벤트 모니터링을 중지합니다.

unmonitorEvents(window);

객체에서 특정 이벤트의 모니터링을 선택적으로 중지할 수도 있습니다. 예를 들어 다음 코드는 현재 선택된 요소의 모든 마우스 이벤트 모니터링을 시작하고 'mousemove' 이벤트 모니터링을 중지합니다 (콘솔 출력의 노이즈를 줄이기 위해).

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

values(객체)

values(object)는 지정된 객체에 속한 모든 속성의 값이 포함된 배열을 반환합니다.

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

values(player);

값의 결과(플레이어)입니다.