【Node.js24.x】btoa::btoa()関数の使い方

btoa関数は、引数として渡されたASCII文字列をBase64形式のASCII文字列にエンコードする関数です。この関数は、Node.jsのグローバルスコープで利用できる組み込み機能であり、Webブラウザ環境で広く利用されているwindow.btoaと同様の動作を提供します。

主に、バイナリデータや特殊文字を含むデータを、テキストデータのみを扱える環境（例えば、HTTPヘッダやデータURI、特定のデータ転送プロトコルなど）で安全に転送したり保存したりする必要がある場合に利用されます。btoa関数によって生成されたBase64文字列は、元のデータを完全に復元可能な形で表現されます。

使用例としては、画像のような小さなバイナリデータをHTMLの<img>タグのsrc属性に直接埋め込むデータURIスキームや、認証情報などをHTTPリクエストヘッダに含める際などに活用されます。

しかしながら、btoa関数は入力として純粋なASCII文字のみをサポートしており、日本語や絵文字などの非ASCII文字（ユニコード文字）を含む文字列を直接エンコードしようとすると、エラーが発生します。このようなユニコード文字列をBase64エンコードしたい場合は、Node.jsのBufferオブジェクトなどを用いて、一度UTF-8などの適切な文字エンコーディングに変換してからBase64エンコードを行う必要があります。

Copy
1const encodedString = btoa('string to encode');

input

• input: string: Base64エンコードする文字列

string

btoa関数は、入力された文字列をBase64エンコードした結果を文字列として返します。