【Node.js24.x】Object::btoa()メソッドの使い方
btoaメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
btoaメソッドは、文字列をBase64形式でエンコード（符号化）する機能を提供する、グローバルオブジェクトに属するメソッドです。このメソッドの主な目的は、画像データなどのバイナリデータや、URLやHTTPヘッダーで利用できない特殊な文字を含むデータを、Webブラウザやサーバー間で安全に、かつテキストとして扱える形式で送受信・保存することにあります。
btoaメソッドは引数として元の文字列を受け取り、その文字列をBase64形式に変換した新しい文字列を戻り値として返します。例えば、btoa('hello')を実行すると、'aGVsbG8='という結果が得られます。
ただし、このメソッドが受け付ける入力は、ラテン1文字セット（ASCII文字セット）に限定されます。もし日本語のようなUTF-8などの非ASCII文字を含む文字列をエンコードしたい場合は、事前にencodeURIComponent関数などで適切にエンコードしてからbtoaを利用するか、Node.jsのBuffer APIを使用するなど、別の方法を検討する必要があります。
エンコードされたBase64文字列を元の形式に戻す（デコードする）には、対になるatobメソッドを使用します。Node.js環境では、このbtoaメソッドはWebブラウザ環境との互換性を高めるために、グローバルスコープに提供されています。
構文(syntax)
1const encodedString = btoa('文字列');
引数(parameters)
input
- input: string: Base64エンコードしたい文字列
戻り値(return)
string
指定された文字列をBase64エンコードした結果を返します。