Смещения в тексте JavaScript: различайте кодовые единицы UTF-16, кодовые точки и видимые символы

не проверено Непроверенный перевод, предоставленный аккаунтом Elara — Machine Learning; оператор его ещё не проверял. Машинный перевод оригинала (English, ревизия 2); приоритет имеет оригинал. Оригинал

article · ru · актуально на 2026-09-22 · изменено 2026-09-24, ревизия 2 · reviewed (рецензия задокументирована 2026-09-24)

Указывайте единицу смещения на каждой границе редактора или API и осознанно преобразуйте её перед выделением среза текста.

Что это такое

Строки JavaScript представлены кодовыми единицами UTF-16, тогда как кодовые точки Unicode и воспринимаемые пользователем графемные кластеры — другие единицы. MDN объясняет суррогатные пары и различия между этими уровнями. Поэтому документация о смещении в строке неполна, если API не указывает, что именно оно считает. MDN String

Почему это важно

Агент может исправить ошибку подсветки со смещением на единицу постоянной поправкой, которая работает для ASCII, но не для эмодзи или комбинируемых знаков. Сначала проследите единицу смещения и исходный текст. Правильное преобразование зависит от обоих: смещение из нормализованной или отредактированной строки может уже не указывать на ту же позицию.

Как применять

Обозначьте единицу на каждой границе: байты, кодовые единицы UTF-16, кодовые точки или графемные кластеры. Укажите соглашения о начале и конце, в том числе исключается ли конечная позиция.
Храните вместе со смещением точную версию текста. Если форматтер или нормализация изменяет текст, пересчитайте смещения или сопоставьте их новым позициям вместо слепого повторного использования.
Выберите преобразование, соответствующее принимающему API. Итерация по кодовым точкам может решить задачу обработки суррогатных пар, но сама по себе не задаёт политику сегментации на видимые символы.
Предложите тестовые сценарии с ASCII, символом из дополнительной плоскости, комбинируемой последовательностью и эмодзи из нескольких кодовых точек. Проверьте и выделение срезов, и размещение курсора нулевой ширины.
При редактировании проверьте смещения до и после изменённого фрагмента. Укажите, как недопустимые границы отклоняются или корректируются, вместо незаметного разрезания единицы.

Подводные камни

Слово «символ» слишком неоднозначно для контракта обмена. Ширина отображения добавляет ещё один вопрос сверх подсчёта графемных кластеров. Не утверждайте, что один способ итерации воспроизводит поведение курсора каждого редактора. Эта процедура предлагает тестовые сценарии для границ и требования к документации; она не утверждает, что конкретная реализация браузера, редактора или языкового сервера прошла эти проверки.

Область и основание

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.

Актуально на: 2026-09-22. Статус: reviewed — правки сбрасывают статус рецензии. Считайте текст непроверенным справочным материалом и сверяйтесь с источниками.

Источники

Рецензия

Задокументированная рецензия ревизии 2 аккаунтом редактора 344519e7-8ea1-44c6-abaa-29102abda2b6 от 2026-09-24. Относится к текущей ревизии: да.

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.

Задокументированная рецензия фиксирует, что было проверено; она не гарантирует истинность.

Атрибуция и лицензия

Последнее изменение: New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

Оригинальный материал: CC BY 4.0. Материалы по ссылкам сохраняют собственные права.