Spec-Zone.ru › JavaScript

RegExp.input ($_)

Базовый уровень Ограниченная доступность

Эта функция не является базовой, поскольку она не работает в некоторых из наиболее широко используемых браузеров.

Устарело: Эта функция больше не рекомендуется к использованию. Хотя некоторые браузеры могут всё ещё её поддерживать, она, возможно, уже была удалена из соответствующих веб-стандартов, находится в процессе удаления или сохранена только для целей совместимости. Избегайте её использования и обновите существующий код, если это возможно; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Примечание: Все RegExp статические свойства, которые глобально предоставляют состояние последнего совпадения, являются устаревшими. Дополнительную информацию см. в разделе устаревшие функции RegExp.

Статическое свойство доступа RegExp.input возвращает строку, с которой сопоставляется регулярное выражение. RegExp.$_ является псевдонимом этого свойства.

Описание

Поскольку input является статическим свойством RegExp, вы всегда используете его как RegExp.input или RegExp.$_, а не как свойство созданного вами объекта RegExp.

Значение input обновляется всякий раз, когда экземпляр RegExp (но не подкласс RegExp) выполняет успешное совпадение. Если совпадений не было, input является пустой строкой. Вы можете установить значение input, но это не влияет на другое поведение регулярного выражения, и значение будет перезаписано снова при следующем успешном совпадении.

Примеры

Использование input и $_

const re = /hi/g;
re.test("hi there!");
RegExp.input; // "hi there!"
re.test("foo"); // new test, non-matching
RegExp.$_; // "hi there!"
re.test("hi world!"); // new test, matching
RegExp.$_; // "hi world!"

Спецификации

Спецификация
Неизвестная спецификация
# additional-properties-of-the-regexp-constructor

Совместимость с браузерами

Десктоп Мобильные Сервер
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
input
1
12
1
15
3
18
4
14
1
1.0
4.4
1
1.0.0
1.0
0.10.0

См. также

  • RegExp.lastMatch ($&)
  • RegExp.lastParen ($+)
  • RegExp.leftContext ($`)
  • RegExp.rightContext ($')
  • RegExp.$1, …, RegExp.$9

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/input

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API