Performance
===========

La interfaz **`Performance`** representa información relacionada con el tiempo de rendimiento para la página dada.

Un objeto de este tipo puede ser obtenido por el llamado de el atributo de solo lectura `Window.performance` (en-US).

***Nota*:** Esta interfaz y sus miembros están disponibles en Web Workers, exceptuando en los mencionados abajo. También, tenga en cuenta que las marcas y medidas de rendimiento son por contexto. Si crea una marca en el hilo principal (u otro worker), no puedes verlo en un hilo de un worker, y vice versa.

Propiedades
-----------

*La interfaz `Performance` no hereda ninguna propiedad.*

`Performance.navigation` Read only  
Obsoleto

Un objeto del legado `PerformanceNavigation` que provee contexto útil acerca de operaciones, incluidas en los tiempos listados en `timing`, incluyendo si la página fue cargada o refrescada, cuántas redirecciones ocurrieron, entre otros. No disponible en workers

`Performance.timing` Read only  
Obsoleto

Un objeto del legado {domxref("PerformanceTiming")}} que contiene información relacionada con la latencia.

`Performance.memory` Read only  
Non-standard

Una *no standarizada* extensión añadida a Chrome, esta propiedad provee un objeto con información básica de uso de memoria. **No deberías usar** esta *no estandarizada* API.

`Performance.timeOrigin` Read only  
Non-standard

Retorna una marca de tiempo de alta precisión de la hora de inicio de la medida de rendimiento.

Métodos
-------

La interfaz `Performance` no hereda ningún método.

`Performance.clearMarks()`

Elimina la marca dada del búfer de entrada de rendimiento del navegador.

`Performance.clearMeasures()`

Elimina las *medida* dadas del búfer de entrada del navegador.

`Performance.clearResourceTimings()` (en-US)

Elimina todas las {domxref("PerformanceEntry","performance entries")}} con una `entryType` (en-US) de "`resource`" del búfer de datos de rendimiento del navegador.

`Performance.getEntries()` (en-US)

Devuelve una lista de objetos `PerformanceEntry` (en-US) basados en el *filtro dado.*

`Performance.getEntriesByName()` (en-US)

Devuelve una lista de objetos `PerformanceEntry` (en-US) basados en el *nombre* dado y el tipo de *entrada*.

`Performance.getEntriesByType()` (en-US)

Devuelve una lista de objetos `PerformanceEntry` (en-US) de el tipo de *entrada* dado.

`Performance.mark()` (en-US)

Crea un `timestamp` (en-US) en el *búfer de entrada de rendimiento* del navegador.

`Performance.measure()` (en-US)

Crea un `timestamp` (en-US) nombrado en el *búfer de entrada de rendimiento* del navegador entre dos especificadas marcas (conocidas como la *marca de inicio* y *la marca final,* respectivamente).

`Performance.now()`

Retorna un `DOMHighResTimeStamp` (en-US) representando el número de milisegundos transcurridos desde un instante de referencia.

`Performance.setResourceTimingBufferSize()` (en-US)

Define el tamaño del búfer de temporización de recursos de "`resource`" a los objetos `type` (en-US) `performance entry` (en-US).

`Performance.toJSON()` (en-US)

Es un jsonizador que retorna un objeto json que respresenta el objecto `Performance`.

Eventos
-------

Escucha a estos eventos que están usando `addEventListener()` o por asignación de un escuchador de eventos a la propiedad `oneventname` de esta interfaz.

`resourcetimingbufferfull` (en-US)

 Disparado cuando "resource timing buffer (en-US)" está lleno.
 También disponible usando la propiedad `onresourcetimingbufferfull` (en-US).


Especificaciones
----------------

| Specification |
| --- |
| High Resolution Time # sec-performance |
| Performance Timeline # extensions-to-the-performance-interface |
| Resource Timing # sec-extensions-performance-interface |
| User Timing # extensions-performance-interface |

Compatibilidad con navegadores
------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.