* insertData method (DOM CharacterData 界面)

[1] [CODE(DOM)[[VAR(DOMi)[[[CharacterData]]]].[CODE(DOMm)[insertData]] ([VAR(DOMp)[offset]], [VAR(DOMp)[arg]])]]
は、文字列 [VAR(DOMi)[CharacterData]] の位置
[VAR(DOMp)[offset]] に [CODE(DOM)[[[DOMString]]]] [VAR(DOMp)[arg]]
を挿入します。

引数 [VAR(DOMp)[offset]] は、文字列中の挿入位置で、
[CODE(DOM)[0]] から始まります。[[サロゲート・ペア]]は1組で2つ分数えられるので注意が必要です。

[2] 結果:
- [CODE(DOM)[[[DOMException]]]]:
:[CODE(DOM)[INDEX_SIZE_ERR]]:[CODE(DOMp)[offset]] が負か、データ中の16ビット単位数よりも大きいです。
:[CODE(DOM)[NO_MODIFICATION_ALLOWED_ERR]]:当該[[節]]は[[読取専用]]です。

サロゲート・ペアの途中に挿入しようとしたらどうなるんでしょうかね?

[3] この method は DOM 水準 1 です。
<http://www.w3.org/TR/DOM-Level-1/level-one-core.html#method-insertData>

[4]

[[引数]]は [CODE(IDL)@en[[[unsigned]] [[long]]]]
で[[負]]にはならないにもかかわらず、
[[負]]の場合 [CODE(DOMc)@en[[[INDEX_SIZE_ERR]]]]
と説明されています。
([[名無しさん]])