recursal/MDN huggingface dataset:
CSSRule: cssText property
=========================

La propiedad **`cssText`** de la interfaz `CSSRule` devuelve el texto real de una regla de estilo `CSSStyleSheet`.

**Nota:** No confunda esta propiedad con el estilo de elemento `CSSStyleDeclaration.cssText` (en-US).

 Tenga en cuenta que esta propiedad ya no se puede configurar directamente, ya que ahora se especifica para ser *funcionalmente* solo modificable, y sin ser notado. En otras palabras, intentar configurarlo *no hace absolutamente nada* y ni siquiera emite una advertencia o un error.
 Además, no tiene subpropiedades configurables. Por lo tanto, para modificarlo, use las propiedades `.selectorText` y `.style` (en-US) (o sus subpropiedades). Véase Uso de información de estilo dinámico (en-US) para más detalles.

Valor
-----

Una cadena que contiene el texto real de la regla `CSSStyleSheet`.

Ejemplos
--------


```css
body {
  background-color: darkblue;
}
```



```js
let stylesheet = document.styleSheets[0];
console.log(stylesheet.cssRules[0].cssText); // body { background-color: darkblue; }
```

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

| Specification |
| --- |
| CSS Object Model (CSSOM) # dom-cssrule-csstext |

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

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
URLSearchParams()
=================

El constructor **`URLSearchParams()`** crea y retorna un nuevo objeto `URLSearchParams`. Si se incluye el caracter `'?'` al comienzo, éste es ignorado.

**Nota:** Esta característica está disponible en Web Workers

Sintaxis
--------
```

var URLSearchParams = new URLSearchParams(init);
```

### Parámetros

*`init`* Opcional

Una instancia de `USVString` (en-US), una secuencia de `USVString` (en-US)s, o un registro conteniendo dos `USVString` (en-US)s.

### Valor retornado

Un objeto instancia de `URLSearchParams`.

Ejemplos
--------

El siguiente ejemplo muestra cómo crear un objeto `URLSearchParams` desde un string que representa una URL.


```js
// Pasar un literal string
var url = new URL("https://example.com?foo=1&bar=2");
// Obtener la URL actual desde window.location
var url2 = new URL(window.location);

// Obtener parámetros de url.search y pasarlos al constructor
var params = new URLSearchParams(url.search);
var params2 = new URLSearchParams(url2.search);

// Pasar una secuencia
var params3 = new URLSearchParams([
  ["foo", 1],
  ["bar", 2],
]);

// Pasar un registro
var params4 = new URLSearchParams({ foo: 1, bar: 2 });
```

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

| Specification |
| --- |
| URL Standard # dom-urlsearchparams-urlsearchparams |

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

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

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

Indica la cantidad de tiempo, en segundos, que faltan para que la batería esté completamente cargada.

**Nota:** Incluso si el tiempo devuelto es exacto al segundo, los navegadores los redondean a un intervalo más alto (típicamente a los 15 minutos más cercanos) por razones de privacidad.

Sintaxis
--------


```js
var time = battery.chargingTime;
```


 La variable `time` recibe el tiempo restante en segundos para que la batería
 esté completamente cargada o 0 (cero) si la `battery` ya está completamente cargada.
 Si la batería está descargándose el valor es `Infinity`.

Ejemplo
-------

### Contenido HTML


```html
<div id="chargingTime">(tiempo de descarga desconocido)</div>
```

### Contenido JavaScript


```js
navigator.getBattery().then(function (battery) {
  var time = battery.chargingTime;

  document.querySelector("#chargingTime").textContent = battery.chargingTime;
});
```

### Resultado

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

| Specification |
| --- |
| Battery Status API # dom-batterymanager-chargingtime |

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

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

Ver también
-----------

* `BatteryManager`
* `Navigator.getBattery`
BatteryManager.onlevelchange
============================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

 La propiedad **`BatteryManager.onlevelchange`** especifica un detector
 de eventos para recibir eventos de `levelchange`. Estos eventos ocurren
 cuando el `level` de batería se actualiza.

Sintaxis
--------


```js
navigator.battery.onlevelchange = funcRef;
```


 Donde `battery` es un objecto `BatteryManager`,
 y `funcRef` es una función que se convoca cuando el evento de `levelchange` sucede.

Ejemplo
-------

### Contenido HTML


```html
<div id="level">(nivel de batería desconocido)</div>
<div id="stateBattery">(estado de carga desconocido)</div>
```

### Contenido JavaScript


```js
navigator.getBattery().then(function (battery) {
  battery.onlevelchange = function () {
    document.querySelector("#level").textContent = battery.level;

    if (battery.charging) {
      document.querySelector("#stateBattery").textContent =
        "Charging time: " + battery.chargingTime / 60;
    } else {
      document.querySelector("#stateBattery").textContent =
        "Discharging time: " + battery.dischargingTime / 60;
    }
  };
});
```

### Resultado

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

| Specification |
| --- |
| Battery Status API # ref-for-dfn-levelchange-1 |
| Battery Status API # dom-batterymanager-onlevelchange |

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

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

Véase también
-------------

* `BatteryManager`
* `Navigator.getBattery`
BatteryManager.dischargingTime
==============================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

 Indíca la cantidad de tiempo, en segundos,
 que restan antes de que la batería se descargue completamente.

**Nota:** Incluso si el tiempo devuelto es exacto al segundo, los navegadores los redondean a un intervalo más alto (típicamente a los 15 minutos más cercanos) por razones de privacidad.

Sintaxis
--------


```js
var time = battery.dischargingTime;
```


 Valor de retorno, `time` es el tiempo restante en segundos antes que la `battery`,
 que es un objeto `BatteryManager`,
 esté completamente descargada y el sistema se suspenda.
 Este valor es `Infinity`
 Si la batería se está cargando en vez de descargando,
 o si el sistema es incapaz de calcular el tiempo de descarga.

Ejemplo
-------

### Contenido HTML


```html
<div id="dischargingTime">(tiempo de descarga desconocido)</div>
```

### Contenido JavaScript


```js
navigator.getBattery().then(function (battery) {
  var time = battery.dischargingTime;

  document.querySelector("#dischargingTime").textContent =
    battery.dischargingTime;
});
```

### Resultado

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

| Specification |
| --- |
| Battery Status API # dom-batterymanager-dischargingtime |

Compatibilidad del navegador
----------------------------

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

Ver también
-----------

* `BatteryManager`
* `Navigator.getBattery`
BatteryManager.level
====================

 La propiedad **`BatteryManager.level`** indica el nivel de carga actual de la batería como un valor entre `0.0` y `1.0`.
 Un valor de `0.0` significa que la batería está vacía y el sistema está a punto de suspenderse.
 Un valor de `1.0` significa que la batería está llena.
 También se devuelve un valor de `1.0` si la implementación no puede determinar el nivel de carga de la batería o si el sistema no funciona con batería.
 Cuando cambia su valor, se ejecuta el evento `levelchange`.

Valor
-----

Un número.

Ejemplo
-------

### Obtener el nivel de la batería

#### HTML


```html
<button id="get-level">Obtener nivel de batería</button>
<div id="output"></div>
```


#### JavaScript


```js
const getLevel = document.querySelector("#get-level");
const output = document.querySelector("#output");

getLevel.addEventListener("click", async () => {
  if (!navigator.getBattery) {
    output.textContent = "El administrador de batería no es compatible";
  } else {
    const manager = await navigator.getBattery();
    const level = manager.level;
    output.textContent = `Battery level: ${level}`;
  }
});
```


#### Resultado

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

| Specification |
| --- |
| Battery Status API # dom-batterymanager-level |

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

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

Véase también
-------------

* `BatteryManager`
* `Navigator.getBattery`
BatteryManager.charging
=======================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

Un valor boleano indicando si está cargando o no la batería del dispositivo (está conectado el cargador).

Sintaxis
--------


```js
var cargando = battery.charging;
```


El valor de retorno, `cargando` indica si la `battery` se está cargando o no, el cual es un objeto `BatteryManager`, está actualmente cargandose, si la batería se está cargando, este valor es `true`. De lo contrario el valor es `false`.

Ejemplo
-------

### Contenido HTML


```html
<div id="cargando">(estado de carga desconocido)</div>
```

### Contenido JavaScript


```js
navigator.getBattery().then(function (battery) {
  var cargando = battery.charging;

  document.querySelector("#cargando").textContent = cargando;
});
```

### Resultado

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

| Specification |
| --- |
| Battery Status API # dom-batterymanager-charging |

Compatibilidad del Navegador
----------------------------

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

Ver también
-----------

* `BatteryManager`
* `Navigator.getBattery`
BatteryManager.onchargingchange
===============================

**Obsoleto:** Esta característica ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, probablemente ya se ha eliminado de los estándares web relevantes, está en proceso de eliminación o solo se conserva por motivos de compatibilidad. Evite usarlo y actualice el código existente si es posible; consulte la tabla de compatibilidad en la parte inferior de esta página para orientar su decisión. Tenga en cuenta que esta característica puede dejar de funcionar en cualquier momento.

Especifica un evento que escucha para recibir eventos `chargingchange`. Estos eventos se producen cuando se actualiza el estado de la batería `charging`.

Sintaxis
--------


```js
battery.onchargingchange = funcRef;
```


Donde `battery` es un objeto `BatteryManager`, y `funcRef` es una función para llamar cuando se produce el evento `chargingchange`.

Ejemplo
-------

### Contenido HTML


```html
<div id="level">(nivel de batería desconocido)</div>
<div id="chargingTime">(tiempo de carga desconocido)</div>
```

### Contenido JavaScript


```js
navigator.getBattery().then(function (battery) {
  battery.onchargingchange = chargingChange();

  function chargingChange() {
    document.querySelector("#level").textContent = battery.level;
    document.querySelector("#chargingTime").textContent = battery.chargingTime;
  }
});
```

### Resultado

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

| Specification |
| --- |
| Battery Status API # ref-for-dfn-chargingchange-1 |
| Battery Status API # dom-batterymanager-onchargingchange |

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

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

Ver también
-----------

* `BatteryManager`
* `Navigator.getBattery`
HTMLCanvasElement.height
========================

La propiedad **`HTMLCanvasElement.height`** es un entero positivo que refleja el atributo `height` del elemento `<canvas>` interpretado en pixeles CSS. Cuando el atributo no esta especificado o esta puesto en un valor invalido(ej. Número negativo), es usado el valor por defecto de 150.

Esta es una de de las dos propiedades que controlan el tamaño del canvas, siendo la otra `HTMLCanvasElement.width`.

Syntax
------
```

var pxl = canvas.height;
canvas.height = pxl;
```

Ejemplos
--------

Dado el siguiente elemento `<canvas>`:


```html
<canvas id="canvas" width="300" height="300"></canvas>
```


Puedes obtener la altura del canvas con el siguiente codigo:


```js
var canvas = document.getElementById("canvas");
console.log(canvas.height); // 300
```

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

| Specification |
| --- |
| HTML Standard # dom-canvas-height |

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

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

Ver también
-----------

* La interfaz que lo define, `HTMLCanvasElement`.
* La otra propiedad que controla el tamaño del canvas, `HTMLCanvasElement.width`.
HTMLCanvasElement.width
=======================

TLa propiedad **`HTMLCanvasElement.width`** es un entero positivo que refleja el atributo `width` del elemento `<canvas>` interpretado en pixeles CSS. Cuando el atributo no esta especificado o se define con un valor invalido (ej. Número negativo), es usado el valor por defecto de 150.

Esta es una de de las dos propiedades que controlan el tamaño del canvas, siendo la otra `HTMLCanvasElement.height`, that controls the size of the canvas.

Syntax
------
```

var pxl = canvas.width;
canvas.width = pxl;
```

Ejemplos
--------

Dado el siguiente elemento `<canvas>` :


```html
<canvas id="canvas" width="300" height="300"></canvas>
```


Puedes obtener el ancho del canvas con el siguiente codigo:


```js
var canvas = document.getElementById("canvas");
console.log(canvas.width); // 300
```

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

| Specification |
| --- |
| HTML Standard # dom-canvas-height |

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

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

Ver también
-----------

* La interfaz que lo define, `HTMLCanvasElement`.
* La otra propiedad que controla el tamaño del canvas,`HTMLCanvasElement.height`.
TextTrack: evento cuechange
===========================

El evento **`cuechange`** se activa cuando un `TextTrack` ha cambiado las anotaciones que se estan mostrando. El evento es activado tanto en `TextTrack` *y* en el `HTMLTrackElement` (en-US) donde esta siendo mostrado, si lo hay.

|  |  |
| --- | --- |
| Burbujas | No |
| Cancelable | No |
| Interfaz | `Event` |
| Propiedad del controlador de eventos | `GlobalEventHandlers.oncuechange` (en-US) |

Ejemplos
--------

### En el TextTrack

Tu puedes preparar una escucha para el evento `cuechange` en un `TextTrack` usando el método `addEventListener()`:


```js
track.addEventListener("cuechange", function () {
  let cues = track.activeCues; // array de las anotaciones actuales
});
```


O puedes solo preparar la propiedad del controlador de eventos `oncuechange` (en-US):


```js
track.oncuechange = function () {
  let cues = track.activeCues; // array of current cues
};
```

### En el elemento track

El subyacente `TextTrack`, indicado por la propiedad `track`, recive un evento `cuechange` cada vez que la anotación que esta siendo actualmente presentada cambia. Est sucede incluso si la pista de texto no está asociada cun un elemento multimedia.

Si la pista de texto *está* asociada con el elemento multimedia, usando el elemento `<track>` como hijo del elemento `<audio>` o del elemento `<video>`, el evento `cuechange` es también enviado al `HTMLTrackElement` (en-US).


```js
let textTrackElem = document.getElementById("texttrack");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});
```


Además, puedes utilizar el controlador de eventos `oncuechange`:


```js
let textTrackElem = document.getElementById("texttrack");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
});
```

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

| Specification |
| --- |
| HTML Standard # event-media-cuechange |
| HTML Standard # handler-texttrack-oncuechange |

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

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

Ver también
-----------

* WebVTT
HTMLFormElement.reset()
=======================

El método **`HTMLFormElement.reset()`** restaura los elementos de un formulario a sus valores por defecto. Este método hace lo mismo que haciendo clic en el botón de restauración.

Si un control del formulario (como el botón de restaurar) tiene el nombre o un id de *reset* enmascarará el método de restauración del formulario. No restaura otros atributos del campo, como el de `disabled`.

Síntaxis
--------
```

HTMLFormElement.reset()
```

Ejemplo
-------


```js
document.getElementById("myform").reset();
```

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

| Specification |
| --- |
| HTML Standard # dom-form-reset-dev |

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

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

Vea también
-----------

* `HTMLFormElement.submit()` (en-US)
GlobalEventHandlers.onsubmit
============================

Manejador de eventos del evento submit para el objeto window.

Sintaxis
--------
```

window.onsubmit = funcRef;
```

### Parametros

* `funcRef` es una referencia a una función.
Ejemplo
-------
```

<html>
<script>
function reg() {
  window.captureEvents(Event.SUBMIT);
  window.onsubmit = hit;
}

function hit() {
  console.log('hit');
}
</script>

<body onload="reg();">
<form>
  <input type="submit" value="submit" />
</form>
<div id="d"> </div>
</body>
</html>
```

Notas
-----

El evento submit se genera cuando el usuario hace click en el boton submit en un formulario (`<input type="submit"/>`).

El evento submit no se genera cuando el usuario llama a la función `form.submit()` directamente.

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

| Specification |
| --- |
| HTML Standard # event-submit |
| HTML Standard # handler-onsubmit |

Browser Compatibility
---------------------

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

### Resumen

**selectorText** recoge/establece la representación en forma de texto, del selector para el grupo de reglas.

### Sintaxis
```

string = cssRule.selectorText
cssRule.selectorText = string
```

### Ejemplo
```

 // for cssrule: body { background-color: darkblue; }
 cssrule = document.styleSheets[1]
 !!TODO!!
 selector = cssrule.selectorText;
 // selector is now "body"
```

### Notas

La implementación puede haber eliminado espacios en blanco no significativos, en el momento de comprobar el selector.

### Especificación

DOM Level 2 Style - cssRule
XMLHttpRequest.abort()
======================

El método **XMLHttpRequest.abort()** aborta la petición si ha sido enviada. Cuando una petición se aborta, readyState se asigna a 0 (UNSENT), pero el evento readystatechange (en-US) no se lanza.

Sintaxis
--------
```

xhrInstance.abort();
```

### Parámetros

Ninguno.

### Valor de retorno

Vacío.

Ejemplo
-------


```js
var xhr = new XMLHttpRequest(),
  method = "GET",
  url = "https://developer.mozilla.org/";
xhr.open(method, url, true);

xhr.send();

xhr.abort();
```

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

| Specification |
| --- |
| XMLHttpRequest Standard # the-abort()-method |

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

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

Ver también
-----------

* Uso de XMLHttpRequest
XMLHttpRequest.timeout
======================

La propiedad **`XMLHttpRequest.timeout`** es un `unsigned long` que representa el número de milisegundos que puede tomar una solicitud antes de que se finalice automáticamente. El valor por defecto es 0, lo que significa que no hay tiempo de espera (*timeout*). *Timeout* no debe utilizarse para solicitudes XMLHttpRequests sincrónicas usadas en un document environment (en-US), pues generará una excepción `InvalidAccessError`. Cuando ocurre un tiempo de espera, se dispara un evento timeout (en-US).

**Nota:** No puede usar un *timeout* para solicitudes sincrónicas con una ventana propietaria (*owning window*).

Uso de *timeout* con una solicitud asincrónica (en-US)

En Internet Explorer, la propiedad *timeout* se puede establecer solo después de llamar al método open() (en-US) y antes de llamar al método send() (en-US).

Ejemplo
-------


```js
var xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);

xhr.timeout = 2000; // tiempo en milisegundos

xhr.onload = function () {
  // Solicitud finalizada. Haz el procesamiento aquí.
};

xhr.ontimeout = function (e) {
  // Tiempo de espera del XMLHttpRequest agotado. Haz algo aquí.
};

xhr.send(null);
```

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

| Specification |
| --- |
| XMLHttpRequest Standard # the-timeout-attribute |

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

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