【PR】を含みます。

フロントエンド

【JavaScript】文字数をカウントする方法|lengthと絵文字への対応

JavaScriptで文字数をカウントする方法と、length・絵文字への対応

JavaScriptで文字数を取得するには、文字列.lengthを使います。絵文字を見た目の1文字として数えたい場合は、Intl.Segmenterを使います。

たとえば「😊」は、見た目では1文字ですが、lengthで数えると2になります。絵文字も1文字として表示したい場合は、数え方を変える必要があります。

この記事では、length・スプレッド構文・Intl.Segmenterで数えた結果を比べます。入力欄に文字を打つたびに文字数を表示する方法や、入力できる文字数を制限する方法もコード付きで紹介します。

lengthで文字数をカウントする

文字列の末尾に.lengthを付けると、長さを数値で取得できます。次の例で、日本語や英数字、何も入力されていない空の文字列を数えた結果を確認できます。

JavaScript
Copy
console.log('こんにちは'.length); // 5
console.log('ABC123'.length); // 6
console.log('ABC'.length); // 3
console.log(''.length); // 0
console.log('a b'.length); // 3
console.log('a\nb'.length); // 3

この例では、全角の「A」も半角の「A」も、どちらも1文字として数えます。半角スペースや改行(\n)も、それぞれ1文字として数えます。

文字数を数える3つの方法の違い

lengthは、見た目の文字数ではなく、JavaScriptが内部で文字列を扱う単位を数えます。この単位をUTF-16コードユニットと呼びます。「A」は1つ、「😊」は2つのコードユニットで表されるため、lengthで数えると、それぞれ1と2になります。

スプレッド構文を使った[...text].lengthでは、コードポイントの数を取得できます。コードポイントは、Unicodeで文字や記号などに割り当てられた番号です。この方法なら「😊」は1と数えられます。ただし、家族の絵文字「👨‍👩‍👧‍👦」は複数のコードポイントを組み合わせているため、1にはなりません。

家族の絵文字も見た目どおり1文字として数えたい場合は、Intl.Segmenterを使います。文字と結合用の記号などをまとめて、書記素クラスタという単位で区切れます。たとえば「か」に結合用の濁点を付けた文字や「👨‍👩‍👧‍👦」を、それぞれ1文字として数えられます。

方法数える単位😊👨‍👩‍👧‍👦選ぶ場面
text.lengthUTF-16コードユニット211HTMLのmaxlengthとそろえる
[...text].lengthコードポイント17Unicodeのコードポイント数が必要
Intl.Segmenter書記素クラスタ11見た目の1文字として数える

maxlengthに合わせる場合はlength、見た目の文字数を表示する場合はIntl.Segmenterを使います。

Intl.Segmenterで絵文字を見た目どおりに数える

Intl.Segmenterで見た目の文字数を取得する

granularity: 'grapheme'を指定すると、書記素クラスタごとに分割できます。分割した結果を配列にし、要素数を取得します。

JavaScript
Copy
const segmenter = new Intl.Segmenter('ja', { granularity: 'grapheme' });
function countCharacters(text) {
  return [...segmenter.segment(text)].length;
}
console.log(countCharacters('こんにちは')); // 5
console.log(countCharacters('😊')); // 1
console.log(countCharacters('👨‍👩‍👧‍👦')); // 1
console.log(countCharacters('🇯🇵')); // 1
console.log(countCharacters('か\u3099')); // 1
console.log(countCharacters('')); // 0

か\u3099は「か」と結合用の濁点を並べた文字列です。家族の絵文字や国旗と同じく、複数のコードポイントを含んでも結果は1になります。

スプレッド構文では数え方が異なる

[...text].lengthで「😊」は1になります。ただし、家族の絵文字や結合用の濁点を含む文字列は1になりません。

JavaScript
Copy
console.log([...'😊'].length); // 1
console.log([...'👨‍👩‍👧‍👦'].length); // 7
console.log([...'🇯🇵'].length); // 2
console.log([...'か\u3099'].length); // 2

家族の絵文字では、4人分の絵文字と、それらをつなぐ3つの記号が別々に数えられます。スプレッド構文に変えるだけでは、見た目の文字数にはそろいません。

Intl.Segmenterのブラウザ別対応状況

現在の主要ブラウザ(Chrome・Edge・Firefox・Safari)は対応しています。古いブラウザも対象にする場合は、利用できるか確認してください。入力デモのコードでは、IntlとIntl.Segmenterの存在を調べています。

対応状況はMDNのIntl.Segmenter対応表で確認できます。

下の入力デモでは、ブラウザがIntl.Segmenterに対応していない場合、見た目の文字数を表示する欄に「未対応」と表示します。

textareaの文字数をリアルタイムに表示する

inputイベントで数え直すと、入力・貼り付け・削除に合わせて表示を更新できます。下の欄に「👨‍👩‍👧‍👦」を貼り付けて、3つの数え方を比べてください。

length(UTF-16): —

スプレッド構文(コードポイント): —

Intl.Segmenter(書記素): —

初期値の「こんにちは😊」は、上から7・6・6です。すべて削除すると0になります。

HTMLとJavaScriptを分けて掲載します。JavaScriptは、次のHTMLより後ろのscript要素内に貼り付けて実行してください。外部ファイルに保存する場合は、defer属性を付けたscript要素で読み込めます。

HTML
Copy
<div class="character-count-demo" id="character-count-compare">
  <label for="character-count-text">数えたい文字列</label>
  <textarea id="character-count-text" rows="3">こんにちは😊</textarea>
  <p>length(UTF-16): <span data-count="length">—</span></p>
  <p>スプレッド構文(コードポイント): <span data-count="spread">—</span></p>
  <p>Intl.Segmenter(書記素): <span data-count="grapheme">—</span></p>
</div>
JavaScript
Copy
(() => {
  const demo = document.getElementById('character-count-compare');
  const input = demo.querySelector('textarea');
  const lengthOutput = demo.querySelector('[data-count="length"]');
  const spreadOutput = demo.querySelector('[data-count="spread"]');
  const graphemeOutput = demo.querySelector('[data-count="grapheme"]');
  const segmenter = typeof Intl !== 'undefined' && typeof Intl.Segmenter === 'function'
    ? new Intl.Segmenter('ja', { granularity: 'grapheme' })
    : null;
  function updateCounts() {
    const text = input.value;
    lengthOutput.textContent = text.length;
    spreadOutput.textContent = [...text].length;
    graphemeOutput.textContent = segmenter
      ? [...segmenter.segment(text)].length
      : '未対応';
  }
  input.addEventListener('input', updateCounts);
  updateCounts();
})();

表示先の要素とIntl.Segmenterは最初に取得・生成し、入力のたびに使い回します。最後のupdateCounts()は、ページを開いた直後の値を表示するための呼び出しです。

このコードの即時関数内でinput.valueを書き換える場合は、その直後にupdateCounts()も呼びます。JavaScriptで値を代入するだけでは、inputイベントは発生しません。

maxlengthで入力上限を設定し、残り文字数を表示する

入力欄にmaxlengthを指定すると、入力できる文字数に上限を付けられます。次の例では、上限を100に設定し、入力するたびに「現在の文字数」と「残り何文字入力できるか」を表示します。

残り文字数は、上限のinput.maxLengthから、入力済みの文字数input.value.lengthを引いて求めます。どちらもUTF-16コードユニットが基準なので、「😊」は2として数えます。

—

「😊」を1つ入力すると「2 / 100(残り 98)」と表示されます。上限とカウンターに同じ単位を使った例です。

残りの数を表示するHTMLとJavaScriptは次のとおりです。JavaScriptは、次のHTMLより後ろのscript要素内で実行するか、defer属性を付けて外部ファイルから読み込んでください。

HTML
Copy
<div class="character-count-demo" id="character-count-limit">
  <label for="character-count-limited-text">100コードユニットまで入力できます</label>
  <textarea id="character-count-limited-text" rows="3" maxlength="100"></textarea>
  <p data-count="remaining">—</p>
</div>
JavaScript
Copy
(() => {
  const demo = document.getElementById('character-count-limit');
  const input = demo.querySelector('textarea');
  const remaining = demo.querySelector('[data-count="remaining"]');
  function updateRemaining() {
    const count = input.value.length;
    const rest = input.maxLength - count;
    remaining.textContent = `${count} / ${input.maxLength}(残り ${rest})`;
  }
  input.addEventListener('input', updateRemaining);
  updateRemaining();
})();

入力が変わるたびに、現在の長さと残りの数を表示します。maxlengthを指定しても、JavaScriptで代入した値は切り詰められません。上限を超える値を代入した場合、この例の残りの数はマイナスになります。

textarea.valueでは改行が\nにそろいます。maxlengthもその値を基準にするので、入力欄の改行は1コードユニットとして数えます。

仕様はMDNのmaxlengthの説明でも確認できます。

見た目の文字数と上限がずれる場合

maxlength="100"では、「😊」は50個で上限に達します。見た目の100文字を上限にしたい場合は、Intl.Segmenterで表示と判定の両方を行います。

次の例は、見た目で100文字を超えたかどうかを判定します。実行にはIntl.Segmenterへの対応が必要です。

JavaScript
Copy
const segmenter = new Intl.Segmenter('ja', { granularity: 'grapheme' });
const MAX_CHARACTERS = 100;
const text = '😊'.repeat(101);
const count = [...segmenter.segment(text)].length;
const isOverLimit = count > MAX_CHARACTERS;
console.log(count); // 101
console.log(isOverLimit); // true

これは上限の判定だけなので、入力内容は削除されません。入力フォームに使う場合は、textを入力欄の値に置き換え、超過時のメッセージ表示に使います。

文字数表示と上限判定には、同じ単位・同じ除外条件を使います。見た目で100文字を許可する入力欄にmaxlength="100"を併用すると、絵文字がある場合に先に入力が止まります。

改行や空白を除いて文字数を数える

HTMLのmaxlengthには、改行や空白を数から除く指定はありません。除外した文字数で制限する場合は、JavaScriptで上限を判定します。

改行だけを除く

LF(\n)とCR(\r)を削除してから数えます。CRLF(\r\n)の改行も、2つの文字をまとめて取り除けます。

JavaScript
Copy
const text = 'あ\r\nい\nう';
const withoutNewlines = text.replace(/[\r\n]/g, '');
console.log(text.length); // 6
console.log(withoutNewlines); // あいう
console.log(withoutNewlines.length); // 3

元の文字列ではCRLFを2、LFを1と数えるので、lengthは6です。textarea.valueでは改行が\nにそろいます。この例は\r\nを含む文字列を直接数えています。この正規表現では、スペースやタブは残ります。

空白文字も除く

\sを使うと、半角・全角スペース、タブ、改行などの空白文字を除けます。改行も消えるので、スペースだけを除きたい場合には使いません。

JavaScript
Copy
const text = 'あ い う\tえ\nお';
const withoutWhitespace = text.replace(/\s/g, '');
console.log(withoutWhitespace); // あいうえお
console.log(withoutWhitespace.length); // 5

半角・全角スペースだけを除く場合は、text.replace(/[  ]/g, '')と書きます。タブや改行を残したいときに使えます。

絵文字も見た目の1文字として数える場合は、除外後の文字列をIntl.Segmenterに渡します。

JavaScript
Copy
const text = '😊 \n👨‍👩‍👧‍👦';
const segmenter = new Intl.Segmenter('ja', { granularity: 'grapheme' });
const withoutWhitespace = text.replace(/\s/g, '');
const count = [...segmenter.segment(withoutWhitespace)].length;
console.log(count); // 2

スペースと改行を除いたあとに数えるので、絵文字2つ分の結果になります。

よくある質問

Q. 文字数とバイト数は同じですか?

A. 同じではありません。バイト数はUTF-8などの文字エンコーディングによって変わります。保存先の制限が「バイト」の場合は、文字数カウンターの値をそのまま使わないでください。

Q. データベースの文字数制限に合わせるには、どの方法を使いますか?

A. データベースと列の型、文字コードを確認して選びます。たとえばMySQLのutf8mb4やPostgreSQLのUTF-8環境で、VARCHAR(100)の文字数制限に合わせる場合は、[...text].lengthでコードポイント数を数えます。

この場合、「😊」は1ですが、家族の絵文字「👨‍👩‍👧‍👦」は7です。Intl.Segmenterで家族の絵文字を1と数えると、データベース側の上限とずれます。バイト数で制限される列では、保存時の文字コードに合わせてバイト数を計算する必要があります。

コードポイント数で100文字まで入力できるようにする場合は、maxlength="100"を付けず、JavaScriptで文字数と上限超過のメッセージを表示します。maxlengthはUTF-16コードユニット数が基準なので、付けたままでは「😊」は50個で入力が止まります。

ブラウザでの判定に加えて、保存前にサーバー側でも同じ条件で確認し、上限を超えた値は保存しないようにします。データベースに保存できる文字数の仕様は、MySQL 8.0の日本語ドキュメントとPostgreSQL 17の日本語ドキュメントで確認できます。

Q. length()と書くとエラーになるのはなぜですか?

A. 文字列のlengthは関数ではなく、数値を返すプロパティだからです。text.length()ではなく、括弧を付けずにtext.lengthと書きます。

まとめ

  • UTF-16コードユニット数の取得とmaxlengthに合わせた表示には、text.lengthを使います。
  • コードポイント数にはスプレッド構文、見た目の文字数にはIntl.Segmenterを使います。
  • 文字数の表示と入力上限の判定には、同じ数え方を使います。改行や空白を除いて制限する場合は、JavaScript側の表示と上限判定に同じ除外処理を使います。
この記事を書いた人
もみじのアイコン画像

もみじ

現役フリーランスWebエンジニア。フロントエンド開発を中心に、Web制作、WordPress、業務効率化ツール開発、PHPを用いた機能改修に携わってきました。社内SEとして業務ツール開発や運用保守を担当した経験もあります。

実務や学習を通じて得た知見をもとに、初心者がつまずきやすいポイントや、現場で役立つ考え方をわかりやすく発信しています。

詳しいプロフィールはこちら

-フロントエンド
-