Определение типа TypeScript для promise.prototype.finally

Для тех, кто интересуется, как заставить это работать изначально без каких-либо прокладок: начиная с TS 2.7 это возможно.

Обратите внимание, что TS 2.7 еще не полностью (26 февраля 2018 г.) совместим с ES2018. Несмотря на то, что все еще есть несколько вещей, отсутствует, Promise.наконец-то попал в версию 2.7. Также tsconfig-schema уже должна принимать ES2018 в качестве цели, но пока TS 2.7 не знает ES2018. На данный момент, чтобы использовать новые функции, такие как Promise.finally, которые уже есть в версии 2.7, вам придется использовать "target": "ESNEXT" в файле tsconfig.json.

Тогда вы сможете написать такой код:

myAsyncFunction().then
(
  (var) => console.log("executing then. " + var)
)
.catch
(
  (var) => console.log("executing catch. " + var)
)
.finally
(
  () => console.log("executing finally.")
)

Обратите внимание, что finally не принимает никаких аргументов в силу своей природы.

ВАЖНО: хотя TS будет правильно транспилировать и понимать, что вы делаете, вам все равно нужно проверить, поддерживает ли ваш JS-движок Promise.finally. В моем случае я использовал NodeJs 8.x, и, конечно же, созданный JS не был исполняемым, потому что Promise.Finally поддерживается, начиная с , в последних ночных сборках NodeJs 10.x Node 10.x (стабильная), см. эту ссылку.

Вы можете написать свой собственный файл d.ts и указать ссылку на него в файле tsconfig.json. Если вы это сделаете, вы можете внести свой вклад в git DefinitelyTyped для других, таких как вы.

Обновлять:

Если я правильно понял, что вы имеете в виду, вы можете расширить существующий класс Promise в своем собственном файле d.ts. Сделайте метод необязательным, чтобы он не сообщал вам, что фактический класс Promise неправильно реализует интерфейс. Вам нужно расширить его как интерфейс.

Ваш файл d.ts должен выглядеть так

declare module 'es6-promise/dist/es6-promise' {
    export interface Promise <R> {
      finally?<U>(onFinally?: () => U | Promise<U>): Promise<U>;
    }
}

И он должен работать корректно...

В качестве примера я создал для вас проект: promise-extension-typescript-example

Я создал запрос на включение в git-репозиторий DefinitelyTyped, надеюсь, он будет принят, и вы сможете скачать его оттуда...