String オブジェクトは文字の並びを表したり操作したりするために使用されます。

解説

文字列は、テキスト形式で表現可能なデータを保持するのに便利です。最もよく使われる操作として、文字列の長さをチェックするlength プロパティ、文字列に対する+ および+= 演算子を用いた文字列の連結、文字列の中の部分文字列の存在や位置をチェックするindexOf() メソッド、部分文字列を取り出すsubstring() メソッドが挙げられます。

文字列の生成

文字列は文字列リテラルからプリミティブとして、またはString() コンストラクターを使用してオブジェクトとして生成することができます。

const string1 = "文字列プリミティブ";const string2 = 'これも文字列プリミティブ';const string3 = `別な文字列プリミティブ`;

const string4 = new String("文字列オブジェクト");

文字列プリミティブと文字列オブジェクトは多くの動作を共有していますが、その他に重要な相違点と注意点があります。下記の「文字列プリミティブと String オブジェクト」を参照してください。

文字列リテラルは単一引用符または二重引用符を使用して指定することができ、どちらでも同様に扱われますが、逆引用符文字` を使用することもできます。最後の形はテンプレートリテラルを指定しています。この形式では式を補完することができます。文字列リテラルの構文については、字句文法を参照してください。

文字へのアクセス

文字列内の個々の文字へのアクセス方法には、2 通りの方法があります。そのひとつはcharAt() メソッドです。

"ねこ".charAt(1); // "こ" が返される

他にも、文字列を配列風のオブジェクトとして扱い、個々の文字を数値インデックスに対応させる方法もあります。

"ねこ"[1]; // "こ" が返される。

ブラケット記法を使用した文字アクセスでは、これらのプロパティに値を設定したり削除したりすることはできません。関連するプロパティを書き込んだり設定したりすることもできません。（より詳細な情報はObject.defineProperty() を参照してください。）

文字列の比較

文字列を比較するには小なり / 大なり演算子を用います。

const a = "a";const b = "b";if (a < b) {  // true  console.log(`${a} は ${b} より小さい`);} else if (a > b) {  console.log(`${a} は ${b} より大きい`);} else {  console.log(`${a} と ${b} は等しい`);}

なお、すべての比較演算子は、=== および== を含め、文字列を大文字小文字を区別して比較します。文字列の大文字小文字を区別せずに比較する一般的な方法は、両方の文字列を同じ種類（大文字または小文字）に変換してから比較することです。

function areEqualCaseInsensitive(str1, str2) {  return str1.toUpperCase() === str2.toUpperCase();}

toUpperCase() とtoLowerCase() のどちらで変換するかはほとんど自由ですが、ラテン文字以外に広げると、どちらが完全に堅牢なとは言えません。例えば、ドイツ語の小文字ß とss はtoUpperCase() によってどちらもSS に変換されますが、トルコ語の文字ı はtoLocaleLowerCase("tr") を使用しない限り、toLowerCase() によってI と等しくない文字として誤って報告されてしまいます。

const areEqualInUpperCase = (str1, str2) =>  str1.toUpperCase() === str2.toUpperCase();const areEqualInLowerCase = (str1, str2) =>  str1.toLowerCase() === str2.toLowerCase();areEqualInUpperCase("ß", "ss"); // true; should be falseareEqualInLowerCase("ı", "I"); // false; should be true

ロケールを意識して大文字と小文字を区別せずに比較するための堅牢な解決策は、Intl.Collator API を使用するか、文字列のlocaleCompare() メソッド（インターフェイスは同じです）をsensitivity オプションで"accent" または"base" に設定します。

const areEqual = (str1, str2, locale = "en-US") =>  str1.localeCompare(str2, locale, { sensitivity: "accent" }) === 0;areEqual("ß", "ss", "de"); // falseareEqual("ı", "I", "tr"); // true

localeCompare() メソッドはstrcmp() と同様の方法で文字列を比較することができます。ロケールを意識した方法で文字列を並べ替えることができます。

文字列プリミティブと String オブジェクト

JavaScript では、String オブジェクトとプリミティブ文字列は区別されることに注意してください。（Boolean やNumber にも同じことが言えます。）

文字列リテラル（二重引用符または単一引用符で示されます）、およびString 関数をコンストラクター以外の場面で（すなわちnew キーワードを使わずに）呼び出した場合はプリミティブの文字列になります。文字列プリミティブに対してメソッドを呼び出したり、プロパティを参照したりするコンテキストでは、JavaScript は自動的に文字列プリミティブをラップし、ラッパーオブジェクトに対してメソッドを呼び出したり、プロパティを参照したりします。

const strPrim = "foo"; // リテラルは文字列プリミティブconst strPrim2 = String(1); // 文字列プリミティブ "1" に変換const strPrim3 = String(true); // 文字列プリミティブ "true" に変換const strObj = new String(strPrim); // new を付けて String を呼び出すと文字列ラッパーオブジェクトを返すconsole.log(typeof strPrim); // "string"console.log(typeof strPrim2); // "string"console.log(typeof strPrim3); // "string"console.log(typeof strObj); // "object"

プリミティブの文字列とString オブジェクトはeval() を使用すると異なる結果となります。eval に渡されたプリミティブは、ソースコードとして扱われます。String オブジェクトは他のオブジェクトと同様に、オブジェクトとしてそのままの文字列を返します。

const s1 = "2 + 2"; // 文字列プリミティブを生成const s2 = new String("2 + 2"); // String オブジェクトを生成console.log(eval(s1)); // 数値の 4 を返すconsole.log(eval(s2)); // 文字列の "2 + 2" を返す

こういった理由から、プリミティブの文字列を期待して実装されたコードはString オブジェクトでうまく動作しないことがあります。しかし、一般的にはこれらの違いを考慮しなければならないことはあまりありません。

なお、String オブジェクトはvalueOf() メソッドを用いることで、プリミティブの文字列に変換することができます。

console.log(eval(s2.valueOf())); // 数値の 4 を返す

文字列変換

文字列を期待する組み込み操作の多くは、最初に引数を文字列に変換します（これがString オブジェクトが文字列プリミティブと同じように動作する主な理由です）。処理は以下のように要約できます。

• 文字列はそのまま返します。
• undefined は"undefined" なります。
• null は"null" になります。
• true は"true" に、false は"false" になります。
• 数値はtoString(10) と同じアルゴリズムで変換されます。
• 長整数はtoString(10) と同じアルゴリズムで変換されます。
• シンボルはTypeError が発生します。
• オブジェクトは最初にプリミティブに変換され、これは[Symbol.toPrimitive]() を（"string" をヒントとして）呼び出すことで行われ、次にtoString()、そしてvalueOf() メソッドがこの順序で呼び出されます。結果のプリミティブはそれから文字列に変換されます。

JavaScript でほぼ同じ効果を得る方法はいくつかあります。

• テンプレートリテラル:`${x}` は埋め込まれた式に対して、上記で説明した文字列変換と同じ手順を踏みます。
• String() 関数:String(x) はx を変換するのに同じアルゴリズムを使用しますが、シンボルでもTypeError が発生せず、"Symbol(description)" の形でdescription にそのシンボルの説明が入ったものを返します。
• + 演算子:"" + x はオペランドを文字列ではなくプリミティブに変換します。一部のオブジェクトでは、通常の文字列変換とは完全に異なる動作をします。詳しくはリファレンスページを参照してください。

用途によっては`${x}` （組み込みの動作を模倣するため）またはString(x)（エラーを発生させずにシンボル値を処理するため）を使用したいかもしれませんが、"" + x は使用しないでください。

UTF-16 文字、Unicode コードポイント、書記素クラスター

文字列は基本的にUTF-16 コード単位の並びとして表します。UTF-16 エンコーダーでは、すべてのコード単位は正確に 16 ビット長です。つまり、単一の UTF-16 コード単位として表現可能な文字は、最大で 2¹⁶ 個、つまり 65536 通りあります。この文字集合は基本多言語面 (BMP) と呼ばれ、ラテン語、ギリシャ語、キリル文字のような最も一般的な文字や多くの東アジアの文字を含みます。各コード単位はu の文字列の後にちょうど 4 つの 16 進数を続けて書くことができます。

しかし、Unicode の文字集合全体は 65536 よりはるかにずっと大きいのです。追加の文字は UTF-16 でサロゲートペアとして格納されます。これは単一の文字を表す 16 ビットのコード単位のペアです。曖昧さを避けるために、ペアの 2 つの部分は0xD800 と0xDFFF の間でなければならず、これらのコード単位は単一のコード単位の文字をエンコードするためには使用しません。（より正確に言えば、上位サロゲート（上位サロゲートコード単位とも呼ばれる）は、0xD800から0xDBFF（両端値を含む）までの値を持ち、下位サロゲート（下位サロゲートコード単位とも呼ばれる）は、0xDC00 から0xDFFF（両端値を含む）までの値を持ちます。各 Unicode コードポイントは文字列の中で\u{xxxxxx} と書くことができ、ここでxxxxxx は 1-6 桁の 16 進数を表します。

「孤立サロゲート」とは、下記の記述のいずれかを満たす 16 ビットのコード単位です。

• 0xD800 から0xDBFF までの範囲（つまり上位サロゲート）にあるものの、文字列の最後のコード単位であるか、次のコード単位が下位サロゲートではないもの。
• 0xDC00 から0xDFFF までの範囲（つまり下位サロゲート）にあるものの、文字列の最初のコード単位であるか、前のコード単位が上位サロゲートではないもの。

孤立サロゲートは Unicode 文字を表しません。すべて UTF-16 コード単位に基づいて動作するため、ほとんどの JavaScript 組み込みメソッドは正しく扱いますが、他のシステムとやりとりするとき、孤立サロゲートはしばしば有効な値ではありません。例えば、encodeURI() は孤立サロゲートがあるとURIError が発生します。これは URI エンコーディングが UTF-8 エンコーディングを使用しており、孤立サロゲートに対するエンコーディングを持たないためです。孤立サロゲートを格納しない文字列はwell-formed 文字列と呼ばれ、UTF-16 を扱わない関数（encodeURI() やTextEncoder など）で使用しても安全です。isWellFormed() メソッドで文字列が整形されているか調べたり、toWellFormed() メソッドで孤立サロゲートをサニタイズすることができます。

Unicode 文字の上に、書記素クラスターと呼ばれる 1 つの視覚単位として扱われるべき Unicode 文字並びがあります。最も一般的なケースは絵文字で、様々なバリエーションがある絵文字の多くは、実際には複数の絵文字で形成されており、たいていの場合、<ZWJ> (U+200D) 文字で結合されています。

どのレベルの文字を反復処理するのかに注意する必要があります。例えば、split("") は UTF-16 コード単位で分割し、サロゲートペアを区切ります。文字列インデックスも各 UTF-16 コード単位のインデックスを参照します。他にも、[Symbol.iterator]() はUnicode コードポイントで反復処理します。書記素クラスターを反復処理するには独自のコードが必要です。

"😄".split(""); // ['\ud83d', '\ude04']; 孤立サロゲートを 2 つに分割// "Backhand Index Pointing Right: Dark Skin Tone"[..."👉🏿"]; // ['👉', '🏿']// 基本的な "Backhand Index Pointing Right" の絵文字と// "Dark skin tone" の絵文字に分割// "Family: Man, Boy"[..."👨‍👦"]; // [ '👨', '‍', '👦' ]// "Man" と "Boy" の絵文字を ZWJ で結合// アメリカの国旗[..."🇺🇳"]; // [ '🇺', '🇳' ]// 2 つの "region indicator" 文字である "U" と "N"// すべての国旗の絵文字は、2 文字の地域識別文字を結合することで構成されている

コンストラクター

String()

String オブジェクトを生成します。関数として呼び出された場合、String 型のプリミティブ値を返します。

静的メソッド

String.fromCharCode()

指定された Unicode 値の並びから生成した文字列を返します。

String.fromCodePoint()

指定された Unicode コードポイントの並びから生成した文字列を返します。

String.raw()

生のテンプレート文字列から生成した文字列を返します。

インスタンスプロパティ

以下のプロパティはString.prototype で定義されており、すべてのString インスタンスで共有されます。

String.prototype.constructor

インスタンスオブジェクトを作成したコンストラクター関数。文字列インスタンスの場合、初期値はString コンストラクターです。

以下のプロパティはそれぞれのString インスタンスに固有のプロパティです。

length

文字列のlength を反映します。読み取り専用です。

インスタンスメソッド

String.prototype.at()

指定したindex にある文字（UTF-16 コード単位）を返します。負の整数を受け入れ、その場合は文字列の最後の文字から遡ります。

String/charAt

index で指定された位置の文字（UTF-16 コード単位 1 つ）を返します。

String.prototype.charCodeAt()

index で指定された位置の文字の UTF-16 コード単位の値を示す数を返します。

String.prototype.codePointAt()

pos で指定された位置から始まる UTF-16 エンコードされた際のコードポイントの、コードポイントの値である正の整数を返します。

String.prototype.concat()

2 つ（以上）の文字列を連結し、新しい文字列を返します。

String.prototype.endsWith()

文字列がsearchString の文字列で終わるかどうかを判定します。

String.prototype.includes()

呼び出した文字列にsearchString が含まれているかを返します。

String.prototype.indexOf()

この文字列内で、searchValue が最初に現れる位置を返します。見つからなかった場合は-1 を返します。

String.prototype.isWellFormed()

文字列に孤立サロゲートが含まれているかどうかを示す論理値を返します。

String.prototype.lastIndexOf()

この文字列内で、searchValue が最後に現れる位置を返します。見つからない場合は-1 を返します。

String.prototype.localeCompare()

参照文字列compareString が、並べ替え順において、与えられた文字列の前になるか後になるか、あるいは、同じかどうかを示す数値を返します。

String.prototype.match()

文字列に対して正規表現regexp を一致させるために使用されます。

String.prototype.matchAll()

regexp が一致するものすべてのイテレーターを返します。

String.prototype.normalize()

呼び出された文字列の値の Unicode 正規化形式を返します。

String.prototype.padEnd()

現在の文字列の末尾から指定された文字列で埋めた、長さtargetLength 文字の新たな文字列を返します。

String.prototype.padStart()

現在の文字列の先頭から指定した文字列で埋めた、長さtargetLength 文字の新たな文字列を作成します。

String.prototype.repeat()

オブジェクトの要素をcount 回繰り返した文字列を返します。

String.prototype.replace()

searchFor が現れたところをreplaceWith で置換するために使用します。searchFor は文字列または正規表現であり、replaceWith は文字列または関数です。

String.prototype.replaceAll()

searchFor が現れたところすべてをreplaceWith で置換するために使用します。searchFor は文字列または正規表現であり、replaceWith は文字列または関数です。

String.prototype.search()

正規表現regexp と呼び出された文字列が一致するところを検索します。

String.prototype.slice()

文字列の一区間を取り出し、新しい文字列を返します。

String.prototype.split()

呼び出した文字列を、部分文字列sep が現れるところで分割し、文字列の配列を生成して返します。

String.prototype.startsWith()

呼び出した文字列が文字列searchString で開始されているかを判断します。

String.prototype.substr()非推奨;

指定されたインデックスから、指定された文字数だけ文字列の一部を返します。

String/substring

呼び出した文字列の指定された位置以降（または区間）にある文字が入った新しい文字列を返します。

String.prototype.toLocaleLowerCase()

文字列内の文字が、現在のロケールに沿って小文字に変換されます。

ほとんどの言語では、これはtoLowerCase() と同じものを返します。

String.prototype.toLocaleUpperCase()

文字列内の文字が、現在のロケールに沿って大文字に変換されます。

ほとんどの言語では、これはtoUpperCase() と同じものを返します。

String.prototype.toLowerCase()

小文字に変換された文字列の値を呼び出して返します。

String.prototype.toString()

指定されたオブジェクトの文字列を返します。Object.prototype.toString() メソッドを上書きします。

String.prototype.toUpperCase()

大文字に変換された文字列の値を呼び出して返します。

String.prototype.toWellFormed()

この文字列の孤立サロゲートをすべて Unicode 置換文字 U+FFFD に置き換えた文字列を返します。

String.prototype.trim()

文字列の先頭と末尾にあるホワイトスペースを削除します。

String.prototype.trimEnd()

文字列の末尾にあるホワイトスペースを削除します。

String.prototype.trimStart()

文字列の先頭にあるホワイトスペースを削除します。

String/valueOf

指定されたオブジェクトのプリミティブ値を返します。Object.prototype.valueOf() メソッドを上書きします。

String.prototype[Symbol.iterator]()

文字列値のコードポイントを反復処理し、文字列値として各コードポイントを返す、新しいイテレーターオブジェクトを返します。

HTML ラッパーメソッド

String.prototype.anchor()非推奨;

<a name="name">（ハイパーテキストのターゲット）

String.prototype.big()非推奨;

<big>

String.prototype.blink()非推奨;

<blink>

String.prototype.bold()非推奨;

<b>

String.prototype.fixed()非推奨;

<tt>

String.prototype.fontcolor()非推奨;

<font color="color">

String.prototype.fontsize()非推奨;

<font size="size">

String.prototype.italics()非推奨;

<i>

String.prototype.link()非推奨;

<a href="url">（URL へのリンク）

String.prototype.small()非推奨;

<small>

String.prototype.strike()非推奨;

<strike>

String.prototype.sub()非推奨;

<sub>

String.prototype.sup()非推奨;

<sup>

これらのメソッドは文字列そのものが HTML タグを含むかどうかを調べないので、無効な HTML を作成する可能性があることに注意してください。

"</b>".bold(); // <b></b></b>

これらが行う唯一のエスケープは、属性値中の" を（anchor()、fontcolor()、fontsize()、link()において）" に置き換えることです。

"foo".anchor('"Hello"'); // <a name="&quot;Hello&quot;">foo</a>

例

文字列変換

String() 関数は、値のtoString() メソッドを呼び出すよりも、値を文字列に変換する信頼性の高い方法です。前者はnull やundefined に対して使用しても動作するからです。例を示します。

// null や undefined のプロパティにアクセスすることはできないconst nullVar = null;nullVar.toString(); // TypeError: Cannot read properties of nullString(nullVar); // "null"const undefinedVar = undefined;undefinedVar.toString(); // TypeError: Cannot read properties of undefinedString(undefinedVar); // "undefined"

仕様書

ブラウザーの互換性

関連情報

• テキスト処理ガイド
• RegExp