このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

escape()

非推奨

この機能を新しいプロジェクトで使用することは避けてください。 TC39 included the escape() and unescape() methods in Annex B of the ECMAScript specification, which covers JavaScript features with "one or more undesirable characteristics and in the absence of legacy usage would be removed." この機能は、ウェブ標準やブラウザーから除去される可能性があります。

メモ: escape() は、ブラウザーが実装している古い関数で、エンジン間の互換性のためだけに標準化されました。すべての JavaScript エンジンで実装されるとは限らず、すべての環境で動作するとは限りません。可能であれば、encodeURIComponent() または encodeURI() を使用してください。

escape() 関数は、特定の文字を 16 進数のエスケープシーケンスに置き換えた新しい文字列を計算します。

構文

js
escape(str)

引数

str

エンコードする文字列。

返値

特定の文字がエスケープされた新しい文字列。

解説

escape() はグローバルオブジェクトの関数プロパティです。

escape() 関数は、ASCII の単語構成文字 (A–Z、a–z、0–9、_) および @\*_+-./ を除くすべての文字をエスケープシーケンスに置き換えます。文字は UTF-16 コード単位ごとにエスケープされます。コード単位の値が 256 未満の場合は、必要に応じて左側を 0 で埋めた 2 桁の 16 進数 %XX で表します。それ以外の場合は、必要に応じて左側を 0 で埋めた 4 桁の 16 進数 %uXXXX で表します。

メモ: この関数は主にパーセントエンコードに使用され、RFC 1738 のエスケープ形式を部分的に基にしています。このエスケープ形式は、文字列リテラルにおけるエスケープシーケンスではありません。%XX を \xXX、%uXXXX を \uXXXX に置き換えると、実際の文字列リテラル用エスケープシーケンスを含む文字列を取得できます。

例

escape の使用

js
escape("abc123"); // "abc123"
escape("äöü"); // "%E4%F6%FC"
escape("ć"); // "%u0107"

// 特殊文字
escape("@*_+-./"); // "@*_+-./"

仕様書

仕様書
ECMAScript® 2027 Language Specification
# sec-escape-string

ブラウザーの互換性

関連情報