---
title: document.characterSet
slug: Web/API/Document/characterSet
tags:
  - API
translation_of: Web/API/Document/characterSet
---
<p>{{ ApiRef("DOM") }}</p>

<p><code><strong>Document.characterSet</strong></code> 只读属性返回当前文档的字符编码。该字符编码是用于渲染此文档的字符集，可能与该页面指定的编码不同。（用户可以重写编码方式。）</p>

<div class="note">
<p><code>document.charset</code> <code>和document.inputEncoding</code> 属性是<code>document.characterSet</code> 的遗留别名。不要再使用它们。</p>
</div>

<h2 id="语法">语法</h2>

<pre class="syntaxbox">var <em>string</em> = document.characterSet</pre>

<h2 id="示例">示例</h2>

<pre class="eval">&lt;button onclick="alert(document.characterSet);"&gt;查看字符集&lt;/button&gt;
//返回当前文档的字符集,比如"ISO-8859-1" 或者 "UTF-8"
</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th>规范</th>
   <th>状态</th>
   <th>Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('DOM WHATWG', '#dom-document-characterset', 'characterSet')}}</td>
   <td>{{Spec2('DOM WHATWG')}}</td>
   <td>初始定义.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

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