--- title: undefined slug: Web/JavaScript/Reference/Global_Objects/undefined tags: - JavaScript - Проста величина translation_of: Web/JavaScript/Reference/Global_Objects/undefined ---
{{jsSidebar("Objects")}}

Глобальна властивість undefined представляє просте значення {{Glossary("Undefined", "undefined")}}. Це один з {{Glossary("Primitive", "простих типів")}} JavaScript.

{{js_property_attributes(0,0,0)}}

{{EmbedInteractiveExample("pages/js/globalprops-undefined.html")}}

Синтаксис

undefined

Опис

undefined is a property of the global object; i.e., it is a variable in global scope. The initial value of undefined is the primitive value {{Glossary("Undefined", "undefined")}}.

In modern browsers (JavaScript 1.8.5 / Firefox 4+), undefined is a non-configurable, non-writable property per the ECMAScript 5 specification. Even when this is not the case, avoid overriding it.

A variable that has not been assigned a value is of type undefined. A method or statement also returns undefined if the variable that is being evaluated does not have an assigned value. A function returns undefined if a value was not {{jsxref("Statements/return", "returned")}}.

While it is possible to use it as an {{Glossary("Identifier", "identifier")}} (variable name) in any scope other than the global scope (because undefined is not a {{jsxref("Reserved_Words", "reserved word")}}), doing so is a very bad idea that will make your code difficult to maintain and debug.

//DON'T DO THIS

// logs "foo string"
(function() { var undefined = 'foo'; console.log(undefined, typeof undefined); })();

// logs "foo string"
(function(undefined) { console.log(undefined, typeof undefined); })('foo');

Приклади

Сувора рівність та undefined

Виконавши строге порівняння змінної із значенням undefined можна перевірити, чи змінна має значення. У прикладі нижче змінна x не ініціалізована, тому умовний операторif буде оцінено як істина (true)

var x;
if (x === undefined) {
   // код у цьому блоці буде виконано
}
else {
   // код у цьому блоку не буде виконано
}

Note: The strict equality operator rather than the standard equality operator must be used here, because x == undefined also checks whether x is null, while strict equality doesn't. null is not equivalent to undefined. See {{jsxref("Operators/Comparison_Operators", "comparison operators")}} for details.

Typeof operator and undefined

Alternatively, {{jsxref("Operators/typeof", "typeof")}} can be used:

var x;
if (typeof x === 'undefined') {
   // these statements execute
}

One reason to use {{jsxref("Operators/typeof", "typeof")}} is that it does not throw an error if the variable has not been declared.

// x has not been declared before
if (typeof x === 'undefined') { // evaluates to true without errors
   // these statements execute
}

if (x === undefined) { // throws a ReferenceError

}

However, this kind of technique should be avoided. JavaScript is a statically scoped language, so knowing if a variable is declared can be read by seeing whether it is declared in an enclosing context. The only exception is the global scope, but the global scope is bound to the global object, so checking the existence of a variable in the global context can be done by checking the existence of a property on the global object (using the {{jsxref("Operators/in", "in")}} operator, for instance).

Void operator and undefined

The {{jsxref("Operators/void", "void")}} operator is a third alternative.

var x;
if (x === void 0) {
   // these statements execute
}

// y has not been declared before
if (y === void 0) {
   // throws a - Uncaught ReferenceError: y is not defined
}

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

Специфікація Статус Коментар
{{SpecName('ES1', '#sec-4.3.9', 'undefined')}} {{Spec2('ES1')}} Первинне визначення. Реалізовано у JavaScript 1.3.
{{SpecName('ES5.1', '#sec-15.1.1.3', 'undefined')}} {{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-undefined', 'undefined')}} {{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-undefined', 'undefined')}} {{Spec2('ESDraft')}}

Підтримка веб-переглядачами

{{Compat("javascript.builtins.undefined")}}