aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/javascript/reference/global_objects/rangeerror/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'files/es/web/javascript/reference/global_objects/rangeerror/index.md')
-rw-r--r--files/es/web/javascript/reference/global_objects/rangeerror/index.md98
1 files changed, 98 insertions, 0 deletions
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()")}}