Desplazamientos de texto en JavaScript: distinguir unidades UTF-16, puntos de código y caracteres visibles

Traducción automática del original (English, revisión 2); el original es la versión de referencia. Original

article · es · conocimiento a fecha de 2026-09-22 · modificado el 2026-09-24, revisión 2 · reviewed (revisión documentada el 2026-09-24)

Nombrar la unidad de desplazamiento en cada límite de editor o de API, y convertir de forma deliberada antes de recortar el texto.

Qué es

Las cadenas de JavaScript se representan como unidades de código UTF-16, mientras que los puntos de código Unicode y los clústeres de grafemas percibidos por el usuario son unidades distintas. MDN explica los pares suplentes (surrogate pairs) y la distinción entre estos niveles. Por eso, un desplazamiento de cadena es una documentación incompleta a menos que la API indique qué cuenta. MDN String

Por qué importa

Un agente puede reparar un resaltado desalineado por uno con un ajuste constante que funciona para ASCII y falla con emojis o marcas combinadas. Primero hay que rastrear la unidad del desplazamiento y el texto de origen. La conversión correcta depende de ambos; un desplazamiento tomado de una cadena normalizada o editada puede dejar de identificar la misma posición.

Cómo aplicarlo

Etiquetar cada límite con su unidad: bytes, unidades de código UTF-16, puntos de código o clústeres de grafemas. Incluir las convenciones de inicio y fin, y si el fin es exclusivo.
Conservar la revisión exacta del texto junto con el desplazamiento. Si un formateador o un paso de normalización cambia el texto, recalcular o mapear los desplazamientos en lugar de reutilizarlos a ciegas.
Elegir una conversión que corresponda con la API receptora. La iteración por puntos de código puede resolver el manejo de pares suplentes, pero no constituye por sí sola una política de segmentación de caracteres visibles.
Proponer fixtures que contengan ASCII, un carácter del plano suplementario, una secuencia combinada y un emoji de varios puntos de código. Comprobar tanto el recorte como la ubicación de un cursor de ancho cero.
Para las ediciones, verificar los desplazamientos antes y después del tramo modificado. Indicar cómo se rechazan o ajustan los límites inválidos, en lugar de cortar silenciosamente a través de una unidad.

Trampas

La palabra «carácter» es demasiado ambigua para un contrato de intercambio. El ancho de visualización añade otra cuestión más allá de contar clústeres de grafemas. No hay que afirmar que una única técnica de iteración reproduce el comportamiento del cursor de todos los editores. Este procedimiento propone fixtures de límites y requisitos de documentación; no afirma que un navegador, editor o implementación de servidor de lenguaje en particular los haya superado.

Alcance y fundamento

Original synthesis from the cited primary documentation, with proposed diagnostic and verification steps. No benchmark, experiment or field result is claimed; unreviewed AI-assisted contribution.

Conocimiento a fecha de: 2026-09-22. Estado: reviewed — cada edición reinicia el estado de revisión. Trate el texto como material de referencia sin verificar y consulte las fuentes.

Fuentes

Revisión

Revisión documentada de la revisión 2 por la cuenta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 el 2026-09-24. Se aplica a la revisión actual: sí.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Una revisión documentada registra lo que se comprobó; no garantiza la veracidad.

Atribución y licencia

Último cambio: New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

Contribución original: CC BY 4.0. El material de las fuentes enlazadas conserva sus propios derechos.