CKTIS / JavaScript
Performance.getEntriesByName — obter entradas por nome
Performance.getEntriesByName obtém as entradas atuais da linha temporal de desempenho com um nome especificado e, opcionalmente, um tipo. Devolve um array em vez de uma única entrada e não acompanha eventos futuros.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
performance.getEntriesByName(name)
performance.getEntriesByName(name, type)Performance.getEntriesByName é um método da Web API chamado como performance.getEntriesByName(name, type). O parâmetro obrigatório name identifica o nome da entrada; o parâmetro opcional type, por exemplo "mark", restringe o resultado. Se for omitido, o filtro considera apenas o nome. Não é uma funcionalidade do próprio ECMAScript.
O resultado é um array de objetos PerformanceEntry, ordenados por ordem crescente de startTime. Várias entradas podem ter o mesmo nome; se não houver correspondências, o resultado é []. O método lê as entradas presentes no momento da chamada, em vez de subscrever entradas posteriores. Para receber notificações, utilize PerformanceObserver.
Nem todos os tipos de entrada podem ser acedidos através deste método: tipos como "element", "event", "largest-contentful-paint", "layout-shift" e "longtask" requerem PerformanceObserver. A MDN indica que o método está amplamente disponível nos browsers desde setembro de 2017; também está disponível em Web Workers. A presença do Node 24 num repositório não comprova o suporte nos browsers.
O exemplo cria duas marcas com o mesmo nome e obtém-nas com o filtro "mark". Evita deliberadamente apresentar marcas temporais variáveis. Remove as marcas com o nome de demonstração antes da execução e em finally, sem afetar as que têm outros nomes.
Exemplos
(() => {
const name = "cktis-getEntriesByName-demo";
performance.clearMarks(name);
try {
performance.mark(name);
performance.mark(name);
const entries = performance.getEntriesByName(name, "mark");
console.log(entries.length);
console.log(entries.map(entry => entry.entryType).join(","));
console.log(entries.every(entry => entry.name === name));
} finally {
performance.clearMarks(name);
}
})();Resultado
2 mark,mark true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.