undefined

Определение и применение

undefined — единственное значение типа Undefined. Оно часто означает, что значение ещё не было задано или операция не вернула полезного результата. Например, объявленная через let переменная без начального значения содержит undefined.

Сравнение с явным отсутствием значения есть в уроке «null и undefined».

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.undefined
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
undefined✓1✓12✓1✓3✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Использование и проверка

JavaScript
let value;
value === undefined;
typeof value === "undefined";

value здесь уже объявлена. Глобальное свойство undefined доступно только для чтения, не перечисляется и не удаляется. В локальной области это имя технически можно перекрыть параметром или переменной, поэтому не выбирайте его для собственных имён.

Обычные источники undefined

  • Переменная let после объявления без начального значения.
  • Чтение отсутствующего свойства существующего объекта.
  • Не переданный параметр функции.
  • Результат функции без return или с return;.
  • Результат console.log() и alert(), которые выполняют действие без возвращаемых данных.

undefined и необъявленное имя

Чтение необъявленного имени вызывает ReferenceError. Проверка typeof missingName обычно возвращает строку "undefined" без ошибки. Но для имени let или const в той же области до выполнения объявления действует временная мёртвая зона: даже typeof вызовет ReferenceError. Не используйте проверку типа как способ читать переменную раньше объявления.

Отличие от null и пустого текста

undefined === null ложно, хотя нестрогое undefined == null истинно. Пустая строка, ноль и false — другие значения. Выбирайте строгую проверку, если задача требует отличить состояния. Чтение value.length при undefined вызывает TypeError, а не возвращает ноль.

Существующее свойство тоже можно явно заполнить undefined. Сравнение результата чтения с undefined не доказывает, что свойства нет. В примере свойств наличие проверяется отдельно через Object.hasOwn().

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

ECMAScript: undefined.

Примеры, попробуйте сами

Отсутствующее значение и результат действия

Задайте quantity число и добавьте return в функцию: изменятся соответствующие сообщения. Вызов функции остаётся отдельным действием.

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Отсутствующее значение и результат действия</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
let quantity;
function showMessage() {
  console.log("Сообщение показано");
}
console.log(quantity);
const result = showMessage();
console.log(result);
console.log(undefined === null, undefined == null);

Нет свойства или в нём undefined

У объекта есть свойство note, но его значение undefined. Добавьте свойство missing и сравните результаты Object.hasOwn().

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Нет свойства или в нём undefined</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const order = { note: undefined };
console.log(order.note, order.missing);
console.log(Object.hasOwn(order, "note"), Object.hasOwn(order, "missing"));
console.log(typeof unregisteredName);