Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.substring — extraer una parte de una cadena

substring() devuelve la parte de una cadena comprendida entre start y end, sin incluir end. No modifica la cadena original, limita los índices a su longitud e intercambia los límites si están en orden inverso.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

str.substring(start, end)

String.prototype.substring devuelve una cadena primitiva sin modificar la original. Los índices empiezan en cero: start se incluye y end se excluye. Si se omite end o se pasa undefined, se usa el final de la cadena; si se omite start, se usa cero.

Los argumentos se convierten en números y las partes fraccionarias se truncan hacia cero. NaN y los valores negativos se convierten en cero; los valores que superan la longitud de la cadena se limitan a esa longitud. Después, el método intercambia los límites si start es mayor que end. Si los límites son iguales, el resultado es "".

A diferencia de slice(), los índices negativos no cuentan desde el final, y los límites invertidos no fuerzan un resultado vacío. Los índices se refieren a unidades de código UTF-16, no a caracteres visibles completos; separar un par sustituto puede devolver un carácter incompleto.

Este es un método de la biblioteca estándar de ECMAScript, no una API Web. El ejemplo muestra un rango, límites intercambiados, un índice negativo, la omisión de end y un resultado vacío.

Ejemplos

const text = "JavaScript";
console.log(text.substring(4, 10));
console.log(text.substring(10, 4));
console.log(text.substring(-3, 4));
console.log(text.substring(4));
console.log(JSON.stringify(text.substring(4, 4)));

Resultado

Script
Script
Java
Script
""

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes