--- title: document.characterSet slug: Web/API/Document/characterSet tags: - API - DOM - Document - Property - Read-only - Reference translation_of: Web/API/Document/characterSet ---

{{ApiRef("DOM")}}

概要

読み取り専用の Document.characterSet プロパティは、文書の文字エンコーディングを表す文字列を返します。(文字エンコーディングは文字セットであり、入力されたバイト列をどのように文字として解釈するか規定します。)

「文字セット」と「文字エンコーディング」は似ていますが違うものです。プロパティ名に反してエンコーディングを返します。

Content-Type ヘッダーや <meta charset="utf-8">によって開発者が指定した文字エンコーディングはユーザーが上書きできます。例えばFirefoxでは 表示 → テキストエンコーディング メニューから可能です。このような上書き手段は開発者が誤って指定したエンコーディングによって文字化けを引き起こされたときに治すために提供されています。

プロパティ document.charset 及び document.inputEncoding は、document.characterSet への旧来のエイリアスです。これらは使用しないでください。

構文

var string = document.characterSet

<button onclick="console.log(document.characterSet);">
  Log character encoding
</button>
// "ISO-8859-1" や "UTF-8" など、文書の文字セットが開発者コンソールに表示されます

仕様

仕様書 策定状況 コメント
{{SpecName('DOM WHATWG', '#dom-document-characterset', 'characterSet')}} {{Spec2('DOM WHATWG')}} 最初期の定義

ブラウザ実装状況

{{Compat("api.Document.characterSet")}}