diff options
Diffstat (limited to 'files/es/web/javascript/reference/global_objects')
3 files changed, 159 insertions, 115 deletions
diff --git a/files/es/web/javascript/reference/global_objects/evalerror/evalerror/index.md b/files/es/web/javascript/reference/global_objects/evalerror/evalerror/index.md new file mode 100644 index 0000000000..3b488139f2 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/evalerror/evalerror/index.md @@ -0,0 +1,61 @@ +--- +title: EvalError() constructor +slug: Web/JavaScript/Reference/Global_Objects/EvalError/EvalError +browser-compat: javascript.builtins.EvalError.EvalError +--- +{{JSRef}} + +El constructor **`EvalError`** crea un nuevo error relacionado con la función global {{jsxref("Global_Objects/eval", "eval()")}}. Esta excepción ya no es lanzada por JavaScript, sin embargo el objeto `EvalError` permanece por compatibilidad. + +## Sintaxis + +```js +new EvalError() +new EvalError(message) +new EvalError(message, fileName) +new EvalError(message, fileName, lineNumber) +``` + +### Parámetros + +- `message` {{optional_inline}} + - : Descripción del error humanamente legible +- `fileName` {{optional_inline}} + - : El nombre del archivo que contiene el código que causó la excepción +- `lineNumber` {{optional_inline}} + - : El número de línea del código que causó la excepción + +## Ejemplos + +El objeto `EvalError` no se utiliza en la especificación actual de ECMAScript y por lo tanto no será lanzado por el tiempo de ejecución. Sin embargo, el objeto en sí se mantiene para la compatibilidad con versiones anteriores de la especificación. + +### Creación de un EvalError + +```js +try { + throw new EvalError('Hello', 'someFile.js', 10); +} catch (e) { + + console.log(e instanceof EvalError); // true + console.log(e.message); // "Hello" + console.log(e.name); // "EvalError" + console.log(e.fileName); // "someFile.js" + console.log(e.lineNumber); // 10 + console.log(e.columnNumber); // 0 + console.log(e.stack); // "@Scratchpad/2:2:9\n" +} +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- {{jsxref("Error")}} +- {{jsxref("Global_Objects/eval", "eval()")}} + diff --git a/files/es/web/javascript/reference/global_objects/rangeerror/index.html b/files/es/web/javascript/reference/global_objects/rangeerror/index.html deleted file mode 100644 index 154049adca..0000000000 --- a/files/es/web/javascript/reference/global_objects/rangeerror/index.html +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: RangeError -slug: Web/JavaScript/Reference/Global_Objects/RangeError -tags: - - Error - - JavaScript - - Object - - RangeError -translation_of: Web/JavaScript/Reference/Global_Objects/RangeError ---- -<div>{{JSRef}}</div> - -<p>El objeto <code><strong>RangeError</strong></code> indica un error cuando un valor no se encuentra dentro de un rango de valores permitidos.</p> - -<h2 id="Sintaxis">Sintaxis</h2> - -<pre class="syntaxbox"><code>new RangeError([<var>message</var>[, <var>fileName</var>[, <var>lineNumber</var>]]])</code></pre> - -<h3 id="Parámetros">Parámetros</h3> - -<dl> - <dt><code>message</code></dt> - <dd>Opcional. Mensaje de error</dd> - <dt><code>fileName</code> {{non-standard_inline}}</dt> - <dd>Opcional. Nombre del fichero que contiene el código donde se produjo el error</dd> - <dt><code>lineNumber</code> {{non-standard_inline}}</dt> - <dd>Opcional. Número de línea de código donde se produjo el error</dd> -</dl> - -<h2 id="Descripción">Descripción</h2> - -<p>Se lanza un <code>RangeError</code> cuando se pasa como parámetro a una función un número que no está dentro del rango que dicha función permite. Esto puede ocurrir cuando se intenta crear un array con una longitud inválida con el constructor {{jsxref("Array")}}, o al pasar valores inválidos a los métodos numéricos {{jsxref("Number.toExponential()")}}, {{jsxref("Number.toFixed()")}} o {{jsxref("Number.toPrecision()")}}.</p> - -<h2 id="Propiedades">Propiedades</h2> - -<dl> - <dt>{{jsxref("RangeError.prototype")}}</dt> - <dd>Permite añadir propiedades a objetos <code>RangeError</code>.</dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<p><code>RangeError</code> no contiene métodos, pero hereda a través de la <a href="https://developer.mozilla.org/es/docs/Web/JavaScript/Herencia_y_la_cadena_de_protipos">cadena de prototipos</a>.</p> - -<h2 id="Instancias_de_RangeError">Instancias de <code>RangeError</code></h2> - -<h3 id="Propiedades_2">Propiedades</h3> - -<div>{{page('/es/docs/Web/JavaScript/Reference/Global_Objects/RangeError/prototype', 'Propiedades')}}</div> - -<h3 id="Métodos_2">Métodos</h3> - -<div>{{page('/es/docs/Web/JavaScript/Reference/Global_Objects/RangeError/prototype', 'Métodos')}}</div> - -<h2 id="Ejemplos">Ejemplos</h2> - -<h3 id="Utilizando_RangeError">Utilizando <code>RangeError</code></h3> - -<pre class="brush: js">var check = function(num) { - if (num < MIN || num > MAX) { - throw new RangeError('El parámetro debe estar entre ' + MIN + ' y ' + MAX); - } -}; - -try { - check(500); -} -catch (e) { - if (e instanceof RangeError) { - // TODO: Manejar el error de rango - } -} -</pre> - -<h2 id="Especificaciones">Especificaciones</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificación</th> - <th scope="col">Estado</th> - <th scope="col">Comentario</th> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Definición inical.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.6.2', 'RangeError')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-native-error-types-used-in-this-standard-rangeerror', 'RangeError')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidad_en_navegadores">Compatibilidad en navegadores</h2> - -{{Compat("javascript.builtins.RangeError")}} - -<h2 id="Vea_también">Vea también</h2> - -<ul> - <li>{{jsxref("Error")}}</li> - <li>{{jsxref("RangeError.prototype")}}</li> - <li>{{jsxref("Array")}}</li> - <li>{{jsxref("Number.toExponential()")}}</li> - <li>{{jsxref("Number.toFixed()")}}</li> - <li>{{jsxref("Number.toPrecision()")}}</li> -</ul> diff --git a/files/es/web/javascript/reference/global_objects/rangeerror/index.md b/files/es/web/javascript/reference/global_objects/rangeerror/index.md new file mode 100644 index 0000000000..6481f33882 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/rangeerror/index.md @@ -0,0 +1,98 @@ +--- +title: RangeError +slug: Web/JavaScript/Reference/Global_Objects/RangeError +translation_of: Web/JavaScript/Reference/Global_Objects/RangeError +browser-compat: javascript.builtins.RangeError +--- +{{JSRef}} + +El objeto **`RangeError`** indica un error cuando un valor no se encuentra dentro de un rango de valores permitidos. + +## Descripción + +Se lanza un `RangeError` cuando se intenta pasar un valor como argumento a una función +que no permite un rango que incluye el valor. + +Esto puede ocurrir cuando: + +- pasas un valor que no es uno de los valores de cadena permitidos a {{jsxref("String.prototype.normalize()")}}, o +- cuando intentas crear una matriz de una longitud inválida con el constructor {{jsxref("Array")}}, o +- cuando pasas valores inválidos a los métodos numéricos {{jsxref("Number.prototype.toExponential()")}}, + {{jsxref("Number.prototype.toFixed()")}} o {{jsxref("Number.prototype.toPrecision()")}}. + +## Constructor + +- {{jsxref("RangeError/RangeError", "RangeError()")}} + - : Crea un nuevo objecto `RangeError`. + +## Propiedades de instancia + +- {{jsxref("Error.prototype.message", "RangeError.prototype.message")}} + - : Mensaje de error. +- {{jsxref("Error.prototype.name", "RangeError.prototype.name")}} + - : Nombre del error. Heredado de {{jsxref("Error")}}. +- {{jsxref("Error.prototype.fileName", "RangeError.prototype.fileName")}} + - : Ruta al archivo que generó este error. Heredado de {{jsxref("Error")}}. +- {{jsxref("Error.prototype.lineNumber", "RangeError.prototype.lineNumber")}} + - : Número de línea en el archivo que generó este error. Heredado de {{jsxref("Error")}}. +- {{jsxref("Error.prototype.columnNumber", "RangeError.prototype.columnNumber")}} + - : Número de columna en la línea que generó este error. Heredado de {{jsxref("Error")}}. +- {{jsxref("Error.prototype.stack", "RangeError.prototype.stack")}} + - : Seguimiento de pila. Heredado de {{jsxref("Error")}}. + +## Ejemplo + +### Usando RangeError (para valores numéricos) + +```js +function check(n) { + if (!(n >= -500 && n <= 500)) { + throw new RangeError("El argumento debe estar entre -500 y 500."); + } +} + +try { + check(2000); +} catch (error) { + if (error instanceof RangeError) { + // Manejar el error + } +} +``` + +### Usando RangeError (para valores no numéricos) + +```js +function check(value) { + if (["apple", "banana", "carrot"].includes(value) === false) { + throw new RangeError( + 'El argumento debe de ser una "apple", "banana", o "carrot".' + ); + } +} + +try { + check("cabbage"); +} catch (error) { + if (error instanceof RangeError) { + // Manejar el error + } +} +``` + +## Especificaciones + +{{Specifications}} + +## Compativilidad con navegadores + +{{Compat}} + +## Véase también + +- {{jsxref("Error")}} +- {{jsxref("Array")}} +- {{jsxref("Number.toExponential()")}} +- {{jsxref("Number.toFixed()")}} +- {{jsxref("Number.toPrecision()")}} +- {{jsxref("String.prototype.normalize()")}} |