🥺

TypeScriptにBoolean.prototype.toString()がないので自前で型定義する

2023/01/01に公開

地味に困ったので、同じように困っている方もいるんじゃないかと思い記事にしておきます。

前提

JavaScriptには Boolean.prototype.toString() メソッドが存在しています。
Boolean、つまり true, false の値をそれぞれ "true", "false"の文字列に変換することができます。

使用例

true.toString(); // "true"
("a" === "b").toString(); // "false"

VSCode上でTypeScriptファイルを開き true. まで入力してみると、次の入力候補としてvalueOfが表示されますが、toStringは表示されません 🤔

VSCodeで true. まで入力した画面のスクリーンショット。候補としてvalueOfが表示されているが、toStringは表示されていない。

補完が出ないので仕方なく手打ちしてみると、 Object.toString() 扱い、つまりBooleanに定義されているものではなく遡って使用していることになっています 🤔🤔

VSCodeで true.toString() の toString をホバーした様子のスクリーンショット。Object.toString() と表示されている。

それもそのはず、TypeScriptには Boolean.prototype.toString()が定義されていないのである！！！！ （TypeScript 4.9 現在）

なお、型定義がないだけなので、使用ができないわけではありません。
明らかにTSの定義漏れで、2020年にIssueもPRも立てられているのですが、なぜか未だに修正されていません。

各自でできる対応として、型定義ファイル (.d.ts) に以下を追加して対応しました。
これで補完が効くようになります。

global.d.ts

export {};

declare global {
  interface Boolean {
    toString(): string;
  }
}

global.d.ts

export {};

declare global {
  interface Boolean {
    toString(): "true" | "false";
  }
}

解決はしましたが、TS側で修正されてほしいものです 🥺

Stringコンストラクタ String(true) って、問題がありましたっけ……

たしかにそれでもよかったですね……！！