re:re:actable
Урок 062 минуты чтения

JS vs TS typeof

На этой странице
Кратко

В JavaScript typeof проверяет тип значения во время выполнения. В TypeScript typeof может еще и получить тип существующей переменной или функции на уровне типов.

Вопрос

Чем отличается typeof в JavaScript и TypeScript?

Runtime typeof из JavaScript

В обычном коде typeof возвращает строку с типом значения.

const value = "hello";
 
console.log(typeof value); // "string"

Такой typeof часто используют для narrowing.

function format(value: string | number): string {
  if (typeof value === "number") {
    return value.toFixed(2);
  }
 
  return value.toUpperCase();
}

Type-level typeof в TypeScript

В позиции типа typeof достает тип существующего значения.

const config = {
  apiUrl: "/api",
  retries: 3,
};
 
type Config = typeof config;
// { apiUrl: string; retries: number }

С функциями

function createUser(name: string) {
  return { id: 1, name };
}
 
type CreateUserFn = typeof createUser;
type User = ReturnType<typeof createUser>;

typeof createUser нужен, потому что ReturnType ожидает тип функции, а не значение.

Главное отличие

if (typeof value === "string") {
  // runtime-проверка
}
 
type ValueType = typeof value;
// type-level получение типа

Что важно помнить

  • В выражении typeof x — оператор JavaScript (возвращает строку в runtime), в позиции типа — оператор TypeScript (возвращает тип).
  • typeof в типах работает только со значениями (переменными, свойствами), а не с вызовами функций.
  • Частые связки: ReturnType<typeof fn>, keyof typeof obj, (typeof arr)[number].
  • С as const typeof дает точные литеральные типы.

Мини-шпаргалка

  • В JS typeof value возвращает строку во время выполнения.
  • В TS typeof value в типовой позиции достает тип значения.
  • Runtime typeof помогает narrowing.
  • Type-level typeof часто используют с ReturnType, Parameters, InstanceType.

Документация

TypeScript Handbook: Typeof Type Operator.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам