【Node.js24.x】String::lengthプロパティの使い方

lengthプロパティは、Stringオブジェクトが保持する文字列の長さを数値として保持するプロパティです。このプロパティは、文字列に含まれるUTF-16コードユニットの数を返します。具体的には、文字列中の各文字がそれぞれ1つのコードユニットとして数えられ、その総数が長さとして提供されます。例えば、「Hello」という文字列の場合、lengthプロパティは5を返します。

このプロパティは読み取り専用であり、その値を直接変更することはできません。文字列の長さは、Stringオブジェクトが生成された時点で決定され、その後変更されることはありません。空の文字列（""）の場合、lengthプロパティは0を返します。

Node.jsを含むJavaScriptの文字列は内部的にUTF-16で表現されるため、lengthプロパティはUTF-16コードユニットの数を数えます。これにより、絵文字や一部の特殊文字（サロゲートペアと呼ばれる文字）のように、見た目には1文字であっても内部的に2つのUTF-16コードユニットで構成される文字の場合、lengthプロパティは2を返す点に注意が必要です。そのため、見た目の文字数とlengthプロパティが返す数値が一致しないケースが存在します。文字列の長さを確認する際に、この点を考慮することが重要です。このプロパティを利用することで、プログラム内で文字列の長さを効率的に取得し、条件分岐やループ処理などに活用できます。

const myString = "これは文字列です。";
console.log(myString.length);

引数なし

引数はありません

number

文字列の長さを表す数値を返します。この数値は、文字列に含まれる文字の個数を示します。