typeof

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

Оператор typeof возвращает строку с названием типа значения. Такая проверка помогает выбрать, что делать со значением, когда его тип заранее неизвестен.

Например, функция поиска может получить строку запроса или null. Если typeof query === "string", можно вызвать query.trim() и убрать пробелы по краям. При null этот вызов привёл бы к ошибке.

У typeof восемь возможных результатов: "undefined", "boolean", "number", "bigint", "string", "symbol", "function", "object".

Как проверить тип

В таблице value — объявленная переменная. Каждая проверка возвращает true или false.

Вопрос, Проверка
Вопрос Проверка
Это undefined? value === undefined4
Это null? value === null1
Это логическое значение? typeof value === "boolean"
Это число типа number? typeof value === "number"
Это bigint? typeof value === "bigint"
Это строка? typeof value === "string"
Это символ? typeof value === "symbol"
Это объект? Object(value) === value2
Это массив? Array.isArray(value)1
Это функция или класс? typeof value === "function"3

1 Для массива и для null оператор typeof возвращает "object". Чтобы распознать массив, используйте Array.isArray(value). Чтобы проверить значение на null, используйте value === null.

2 Если value уже объект (в том числе массив или функция), Object(value) возвращает тот же объект. Для примитива результатом будет новый объект, поэтому строгое сравнение даст false.

3 Для класса typeof тоже возвращает "function". Например, после class Product {} проверка typeof Product === "function" даст true, но вызов Product() завершится ошибкой. Экземпляр создают через new Product().

4 Особый случай в браузере — document.all. Из-за совместимости со старыми страницами typeof document.all возвращает "undefined", хотя document.all === undefined даёт false.

В справочнике можно сравнить все восемь типов данных, а в уроке «Типы данных» — разобрать их на задачах.

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

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

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

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

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

Синтаксис

JavaScript
typeof значение

значение — проверяемое выражение или имя. Оператор возвращает строку и сам не меняет проверяемое значение.

Примеры

Результаты typeof

Вывод: object, object, function, undefined, number. Замените массив числом и сравните строку типа.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Результаты typeof</title>
</head>
<body>
  <script src="main.js"></script>
</body>
</html>
main.js
JavaScript
console.log(typeof null);
console.log(typeof [1, 2]);
console.log(typeof class {});
console.log(typeof notDeclared);
console.log(typeof NaN);

Необъявленное имя и TDZ

Перенесите let price = 120 выше строки с typeof price и запустите пример ещё раз. Как изменится вторая строка вывода?

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Необъявленное имя и TDZ</title>
</head>
<body>
  <script src="main.js"></script>
</body>
</html>
main.js
JavaScript
console.log(typeof missingPrice);
try {
  console.log(typeof price);
  let price = 120;
} catch (error) {
  console.error(error.name);
}

Имя missingPrice нигде не объявлено, поэтому typeof missingPrice возвращает "undefined". Переменная price объявлена через let в том же блоке. До выполнения строки let price = 120 она находится во временной мёртвой зоне, поэтому typeof price вызывает ReferenceError. То же правило действует для const.

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

ECMAScript: The typeof Operator.