Для чего setTimeout возвращает разные типы?

Question

[tostershmoster]

type F = (...p: any[]) => any

function debounce(fn: F, t: number): F {
  let timeout: ReturnType<typeof setTimeout>;

  return function(...args) {
    clearTimeout(timeout);
    timeout = setTimeout(() => fn(...args), t); // так код работает
    // timeout = setTimeout(fn, t, ...args); // error TS2322: Type 'number' is not assignable to type 'Timeout'.
  }
};

Comments

[Александр]

Используйте window.setTimeout, чтобы не подтягивался тип для Ноды.

Answer 1

[Aetae]

В Node.js setTimeout имеет иную сигнатуру. Если не используете node.js - исключите её типы из tsconfig. Ну или пишите wimdow.setTimeout как советовали в комментах, тем самым указывая на объект window который есть только в браузере.

Comments

[tostershmoster]

Причём тут иная сигнатура в Node.js? Какая бы она не была я ожидаю что при таком написании `() => fn(...args), t` и `fn, t, ...args` будет возвращаться одна и таже сигнатура, в Node.js это будет одна в обоих случаях, не в Node.js другая, но тоже в обоих случаях одинаковая. Почему она разная в зависимости от написания?

[Aetae]

tostershmoster, вся сигнатура, не только возвращаемого значения.
Из-за подключённых node.js типаов у setTimeout без window есть какбы две сигнатуры одновременно: обычная и из ноды. При этом каждая из них имеет несколько перегрузок(overload).

И тут ты прошёлся прямо по полю граблей:
1. ReturnType плохо работает с overload(без дженериков - тупо берёт значение из первой сигнатуры, а не раскрывает все варианты в union).
2. Первая node.js сигнатура (

function setTimeout<[]>(callback: () => void, ms?: number | undefined): NodeJS.Timeout

) требует, чтобы первый аргумент setTimeout был () => void, подо что подходит первый твой вариант(() => any) но не подходит второй((...p: any[]) => any).
3. Во втором варианте, соответственно, берётся следующий подходящий по аргументу overload сигнатуры и вот он то, внезапно, оказывается не из node.js, а из классики.

function setTimeout(handler: TimerHandler, timeout?: number | undefined, ...arguments: any[]): number

, с соответствующим возвратом.

Такое поведение overload'ов наблюдается только в ts 5, в ts 4 такой проблемы нет - сначала по порядку идут overload'ы из node.js и только потом из классики. Видно изменилась логика применения порядка overload'ов при смешении двух деклараций, либо сами декларации как-то поменялись.
В любом случае, имхо, такое поведение - это баг(как минимум - нежелательное поведение) 5ой версии ts и следует создать им на github issue:).