performance.mark()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

mark() 메소드는 브라우저의 performance entry buffer에 주어진 이름으로 timestamp를 생성합니다. timestamp가 정의된 응용프로그램은 Performance 인터페이스의 getEntries*() 메소드들을 통해 불러올 수 있습니다. (getEntries(), getEntriesByName(), getEntriesByType()).

참고: 이 기능은 Web Worker에서 사용할 수 있습니다.

mark의 performance entry는 다음 속성값을 갖습니다:

  • entryType - "mark"로 설정됩니다.
  • name - mark가 생성될 때 주어진 "name"으로 설정됩니다.
  • startTime - mark()가 호출되었을 때의 timestamp가 설정됩니다.
  • duration - "0"으로 설정됩니다. (duration이 없는 mark).

만약 메서드에 주어진 name이 이미 PerformanceTiming 인터페이스 상에 존재한다면 SyntaxError를 throw 합니다.

Syntax

js
performance.mark(name);

Arguments

name

mark의 이름을 나타내는 DOMString.

Return value

void

Example

다음 예시는 mark()를 사용하여 PerformanceMark를 생성하고 불러오는 방법을 보여줍니다.

js
// Create a bunch of marks.
performance.mark("squirrel");
performance.mark("squirrel");
performance.mark("monkey");
performance.mark("monkey");
performance.mark("dog");
performance.mark("dog");

// Get all of the PerformanceMark entries.
const allEntries = performance.getEntriesByType("mark");
console.log(allEntries.length);
// 6

// Get all of the "monkey" PerformanceMark entries.
const monkeyEntries = performance.getEntriesByName("monkey");
console.log(monkeyEntries.length);
// 2

// Clear out all of the marks.
performance.clearMarks();

명세서

Specification
User Timing Level 3
# dom-performance-mark

브라우저 호환성

BCD tables only load in the browser