歴史 W3C DOM 時代 [64] DOMException は DOM1 で導入されました。当時の W3C DOM
は OMG IDL を用いており、その exception として定義されていました。
Java束縛 では Java の例外 に、 JavaScript束縛 では JavaScript の
の例外 に対応付けられることが想定されていました。
[1] DOM では、処理を行えない時に例外exception DOMException
ちなみに、処理が行えない時というのは (1) 論理的理由から行えない時、
(2) データが失われた時 (3) 実装が不安定な時などです。
通常索引に範囲外の値が指定された場合などは例外ではなく
null
[4] DOMException は DOM Core Module の一部です。
すべての DOM 実装が完全に実装しなければなりません。
[5] 仕様書:
[DOM 1] Core Exception DOMException
IW:DOM1:"level-one-core.html#ID-17189187" [DOM 2] Core Exception DOMException
IW:DOM2:"Core/core.html#ID-17189187" [DOM 3] Core Exception DOMException
IW:DOM3:"Core/core.html#ID-17189187" [6] DOMException の例外の種類は定義群
ExceptionCode
[7]
名前 型 出典 code unsigned short [DOM 1,2,3]
[8]
DOMSTRING_SIZE_ERR はほとんどすべての DOMString 型メソッド・属性で発生し得ると思うのですが、
仕様書には一部のメソッド・属性にしか書いてありません。
例えば Node localName 名無しさん )
[9]
IRC logs: freenode / #whatwg / 20080811 (2008-08-14 19:22:43 +09:00 版) http://krijnhoetmer.nl/irc-logs/whatwg/20080811
例外符号 [11]
INVALID_EXPRESSION_ERR 51 DOM XPath (XPathException TYPE_ERR 52 DOM XPath (XPathException NO_SCHEMA_AVAILABLE_ERR 71 DOM妥当性検証 (ExceptionVal PARSE_ERR 81 DOM LS (LSException SERIALIZE_ERR 82 DOM LS (LSException
[53] DOM3 で導入された例外
LSExceptionExceptionValXPathException符号 は DOMException DOM2 で導入されたもの
(EventException RangeException
[83] 完成しなかった DOM AS も古い時期で放棄されたためか DOMException
[132]
時代的に DOM3 より少し後に当たる
GeolicationPositionError
は例外 同様のインターフェイス になっていますが、
符号はかぶっています。
そのためか、
DOMException
以外の例外 が廃止された後も
GeolocationPositionError
は存続しています。
[84] なんで60番台は使われていないのでしょう。
[94] 定義群 ExceptionCodeDOMException 例外 の種類を表す定数群です。
仕様書:
[DOM 1] Core Definition group ExceptionCode
IW:DOM1:"level-one-core.html#ID-258A00AF" [DOM 2] Core Definition group ExceptionCode
IW:DOM2:"Core/core.html#ID-258A00AF" [DOM 3] Core Definition group ExceptionCode
IW:DOM3:"Core/core.html#ID-258A00AF" [95]
定数名 定数値 説明 水準 DOMSTRING_SIZE_ERR 2文の指定された範囲が DOMString DOM 1,2,3 HIERARCHY_REQUEST_ERR 3Node DOM 1,2,3 INDEX_SIZE_ERR 1索引または寸法が負か、認められる値を超えています。 DOM 1,2,3 INUSE_ATTRIBUTE_ERR 10すでにどこかで使われている属性を追加しようとしています。 DOM 1,2,3 INVALID_ACCESS_ERR 15引数または演算に当該物体は対応していません。 DOM 2,3 INVALID_CHARACTER_ERR 5不当または不法な文字が (例えば XML の名前 中で) 指定されています。 DOM 1,2,3 INVALID_MODIFICATION_ERR 13当該物体の型を修正しようとしています。 DOM 2,3 INVALID_STATE_ERR 11使用可能でないか、既に使用不能な物体を使おうとしています。 DOM 2,3 NAMESPACE_ERR 14名前空間に関して不正な方法で物体を作成または変更しようとしています。 DOM 2,3 NOT_FOUND_ERR 8Node を存在しない文脈で参照しようとしています。DOM 1,2,3 NOT_SUPPORTED_ERR 9要求された型の物体または演算に実装は対応していません。 DOM 1,2,3 NO_DATA_ALLOWED_ERR 6データに対応していない Node でデータを指定しています。 DOM 1,2,3 NO_MODIFICATION_ALLOWED_ERR 7修正が認められていない物体を修正しようとしています。 DOM 1,2,3 SYNTAX_ERR 12不当または不法な文字列が指定されています。 DOM 2,3 TYPE_MISMATCH_ERR 17物体の型が物体に関連付けられた引数の型として期待されるものと非互換です。 DOM 3 VALIDATION_ERR 16Node が部分妥当性 について不当となる操作をしようとしています。DOM 3 WRONG_DOCUMENT_ERR 4Node が作られたのと違う文書で使われています。DOM 1,2,3 (その他) (W3C が将来の使用のために予約) DOM 1 SE Second Edition
WHATWG でのメンテナンス [22] W3C DOM は DOM3 を最後に放置されました。
[21] DOMException 例外符号 は、
HTML Standard で規定された他、 WHATWG Wiki のページに一覧が掲載されていて、
他の仕様で規定された追加分もまとめられていました。
[142]
Exception Codes - WHATWG Wiki (2007-09-25 18:06:18 +09:00 版) http://wiki.whatwg.org/wiki/Exception_Codes
[10]
Exception Codes - WHATWG Wiki (2008-08-11 07:36:37 +09:00 版) http://wiki.whatwg.org/wiki/Exception_Codes
[85] IRC logs: freenode / #whatwg / 20100809
(2010-08-14 15:23:27 +09:00 版)
http://krijnhoetmer.nl/irc-logs/whatwg/20100809#l-521
[86] Web Applications 1.0 r5311 Make the structured clone algorithm using DATA_CLONE_ERR rather than NOT_SUPPORTED_ERR, for sicking.Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10069
( (2010-08-18 10:28:00 +09:00 版))
http://html5.org/tools/web-apps-tracker?from=5310&to=5311
[87] Web Applications 1.0 r5416 Fix potential clash with File API.
( (2010-09-07 04:28:00 +09:00 版))
http://html5.org/tools/web-apps-tracker?from=5415&to=5416
[88] IRC logs: freenode / #whatwg / 20100913
( (2010-09-26 22:31:37 +09:00 版))
http://krijnhoetmer.nl/irc-logs/whatwg/20100913
[89] Web Applications 1.0 r5773 File API no longer uses DOMException
( (2011-01-12 05:40:00 +09:00 版))
http://html5.org/tools/web-apps-tracker?from=5772&to=5773
[90] IRC logs: freenode / #whatwg / 20110427
( (2011-04-30 12:39:26 +09:00 版))
http://krijnhoetmer.nl/irc-logs/whatwg/20110427
[91] Bug 10623 – Simplify Web IDL exceptions
( (2011-06-28 23:02:06 +09:00 版))
http://www.w3.org/Bugs/Public/show_bug.cgi?id=10623
[92] IRC logs: freenode / #whatwg / 20110415
( (2012-11-25 02:42:52 +09:00 版))
http://krijnhoetmer.nl/irc-logs/whatwg/20110415#l-993
[93] 743888 – Replace SVGException and XPathException with DOMException
( (2012-11-29 14:51:25 +09:00 版))
https://bugzilla.mozilla.org/show_bug.cgi?id=743888
[96] Chrome は name 属性 に
INUSE_ATTRIBUTE_ERR 2012-12-20T14:58:23.700Z
DOM Standard [23] W3C DOM にかわる WHATWG DOM Standard の標準化により、
すべてのエラーコードが再び一箇所で規定されるようになりました。
またその後の WHATWG や W3C WebApps WG 、 public-script-coord
などの議論で、 Java 風の整数 + 定数 のエラーコードを新規追加せず文字列名によってエラーを区別することや、独自の例外 インターフェイスに替えて専ら
DOMException
[106] DOM Standard (2014-08-19 13:36:28 +09:00 版) http://dom.spec.whatwg.org/#exception-domexception [104] DOM Standard (2014-08-19 13:36:28 +09:00 版) http://dom.spec.whatwg.org/#error-names-0 [97] Bug 101606 – DOMException name is incorrect
( (2012-12-20 15:20:56 +09:00 版))
https://bugs.webkit.org/show_bug.cgi?id=101606
[98] DOM Standard は新しい name 例外 の種類に対してしか定義していませんが、
>>97 は廃止されたものも含めて新しいスタイルの name
[99] 2013-02-07 23:47:57 +09:00 版))
http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2013-February/038857.html
[100] ES Discuss
( (2013-11-06 07:34:10 +09:00 版))
http://esdiscuss.org/topic/creating-your-own-errors
[101] IRC logs: freenode / #whatwg / 20140401
( (2014-04-02 23:03:41 +09:00 版))
http://krijnhoetmer.nl/irc-logs/whatwg/20140401
[102] Inform the world DOMException and DOMError are moving out · db88f3a · whatwg/dom
( (2014-04-11 23:00:00 +09:00 版))
https://github.com/whatwg/dom/commit/db88f3a50274590a52aaabba97cacfaa84853933
[103] Improve warnings in Errors section. · 3287ee4 · whatwg/dom
( (2014-06-05 11:59:35 +09:00 版))
https://github.com/whatwg/dom/commit/3287ee475b41b8ee373affaab368422e500ef3c3
[115] Turns out nobody filed bugs for all these error names. And since IDL is ... · 26a792e · whatwg/dom
( (2014-09-28 08:54:22 +09:00 版))
https://github.com/whatwg/dom/commit/26a792e2375134ca6283797025ed7a9d448220b2
Web IDL 特別なオブジェクト時代 [24] DOMException 例外 を定義する必要が無くなったことから、
Web IDL の exception DOMException DOM Standard から Web IDL
へと移動しました。また、 JavaScript のエラー (単純例外 )
が利用できる場合はそちらを使う方が好ましいと考えられるようになり、
そのための規定も Web IDL で整備されています。
[116] Bug 23367 – Move exceptions into IDL
( (2014-10-04 12:47:53 +09:00 版))
https://www.w3.org/Bugs/Public/show_bug.cgi?id=23367
[117] DOMException is in IDL. DOMError removed. https://www.w3.org/Bugs/Public... · 7fe5736 · whatwg/dom
( (2014-10-10 07:55:36 +09:00 版))
https://github.com/whatwg/dom/commit/7fe5736d3ed2717d71a3d2627b07dee97e10ef05
[118] DOMException is in IDL. DOMError removed. https://www.w3.org/Bugs/Public... · 7fe5736 · whatwg/dom
( (2014-10-10 07:56:55 +09:00 版))
https://github.com/whatwg/dom/commit/7fe5736d3ed2717d71a3d2627b07dee97e10ef05
[119] Removed IDL exceptions, baked in DOMException, and added Error and DOMEx... · 50e172e · heycam/webidl
( (2014-10-10 07:57:03 +09:00 版))
https://github.com/heycam/webidl/commit/50e172ec079db073c3724c9beac1b576fb5dbc47
[18] Web Applications 1.0 r8887 fix exception references to match where things are now defined
(2015-03-05 08:28:00 +09:00 版)
https://html5.org/r/8887
[19] Bug 21740 – Guidance on DOMError and promises
( (2014-02-21 09:14:26 +09:00 版))
https://www.w3.org/Bugs/Public/show_bug.cgi?id=21740
[46] Merge pull request #22 from domenic/domexception-name · heycam/webidl@370fc8c (2015-06-01 22:32:08 +09:00 版) https://github.com/heycam/webidl/commit/370fc8c6e9db2aaf017b266b4b00a36aeedffaf9
[49] Merge pull request #472 from w3c/errorManagement · w3c/webrtc-pc@2774184
(2016-02-05 14:41:18 +09:00 版)
https://github.com/w3c/webrtc-pc/commit/27741843a39b5300fced351be124f54d92dc1970
[50] Merge branch 'not-allowed-error' of git://github.com/mounirlamouri/we… · heycam/webidl@b460b6a
(2016-02-16 11:00:13 +09:00 版)
https://github.com/heycam/webidl/commit/b460b6a875fdfe7dc34f40d1eb57ed1ae8d8f5f5
[54] 743888 – Replace SVGException and XPathException with DOMException
( (2016-05-07 11:33:23 +09:00 ))
https://bugzilla.mozilla.org/show_bug.cgi?id=743888
[55] 21740 – Guidance on DOMError and promises
( (2016-06-03 17:59:45 +09:00 ))
https://www.w3.org/Bugs/Public/show_bug.cgi?id=21740
[56] 27732 – DOMException lost some constants.
(2016-10-26 15:54:35 +09:00 )
https://www.w3.org/Bugs/Public/show_bug.cgi?id=27732
[57] Deprecate InvalidAccessError. (#246)
(tobie 著, 2016-12-08 18:38:08 +09:00 )
https://github.com/heycam/webidl/commit/671706df92e2cece78d747c1db73fbf863e7ec86
[58] Add missing legacy error names. (#251)
(tobie 著, 2016-12-09 21:51:50 +09:00 )
https://github.com/heycam/webidl/commit/c50ffc45f6e8c19262aed531bbe6b047101c3b06
[59] Exception cleanup (#250)
(tobie 著, 2016-12-13 18:46:16 +09:00 )
https://github.com/heycam/webidl/commit/c2d602f15a60765832e52b9c4a62f7ae76b2950c
[60] Editorial: merge deprecated DOMExceptions back in main table (#285)
(tobie 著, 2017-01-25 23:16:13 +09:00 )
https://github.com/heycam/webidl/commit/5c6c00b2ae700caee37ad00450011c2e812b1624
[61] Use DOMException rather than DOMError.
(mkruisselbrink 著, 2017-01-31 07:12:12 +09:00 )
https://github.com/w3c/FileAPI/commit/98f4af667dee7ab88495df90759ed0c225b52672
[62] Clarify that exceptions are always thrown in the current Realm (#300)
(domenic 著, 2017-02-07 15:56:01 +09:00 )
https://github.com/heycam/webidl/commit/20b87a7d44d94a153762a5c1c587779767afbfe6
[43] DOMException は、 DOMExceptionプロトタイプオブジェクト から継承 するプラットフォームオブジェクト によって表されます >>34
[44] DOMException は次の状態を持ちます。大域環境 >>34 Prototype 大域環境 の DOMExceptionプロトタイプオブジェクト >>34 クラス文字列 DOMException >>34
演算 [29] JavaScript 値から DOMException Web IDL値への変換 は、
次のように定義されています >>28 [30] 指定された値が Object DOMException プラットフォームオブジェクト でないなら、
TypeError 投げ 、停止します。[31] 指定された値と同じオブジェクトを指す Web IDL DOMException
[32] Web IDL 値から JavaScript値への変換 は、
次のように定義されています >>28 [33] 指定された値と同じオブジェクトを指す JavaScript Object
大域オブジェクト [35] JavaScript大域オブジェクト は、次の特性 を持たなければなりません >>34 JavaScript特性 名前 DOMException 値 DOMException構築子オブジェクト Writable 真 Enumerable 偽 Configurable 真
構築子オブジェクト [36] DOMException構築子オブジェクトDOMException constructor object 関数オブジェクト でなければなりません >>34 関数オブジェクト Prototype %Error% prototype 特性 JavaScript特性 名前 prototype 値 DOMExceptionプロトタイプオブジェクト Writable 偽 Enumerable 偽 Configurable 偽
[47] DOMException構築子オブジェクト初期オブジェクト です。
[37] 更に、エラー名表 の各定数について、次のような特性 がなければなりません >>34 JavaScript特性 名前 エラー名表 の定数 名値 エラー名表 の定数 値Writable 偽 Enumerable 偽 Configurable 偽
[39] 構築子 としての DOMException構築子オブジェクト は、
実行すると、新しい DOMException オブジェクト を作成し、返します。
第1引数はメッセージ (例外) と解釈されます。第2引数は省略可能で、
指定されたら name code
[38] この関数 は、次のように処理します >>34 F を、活性関数オブジェクト に設定します。newTarget を、 NewTarget (それが undefined F ) に設定します。F の getPrototypeOf super を、その実行結果に設定します。例外 が投げられたなら伝播し、停止します。super に IsConstructor 偽 なら、
TypeError Construct super 、第1引数で構成されるリスト、
newTarget を引数 として渡します。 O を、結果に設定します。O の大域環境 を、本関数 の大域環境 に設定します。第2引数が undefined name を、第2引数の ToString DefinePropertyOrThrow O の特性 を次の通り設定します。
例外 が投げられたなら伝播し、停止します。JavaScript特性 名前 name Value name Writable 真 Enumerable 偽 Configurable 真 DefinePropertyOrThrow O の特性 を次の通り設定します。
例外 が投げられたなら伝播し、停止します。JavaScript特性 名前 code Value エラー名表 で name に相当する符号があればその値、なければ 0Writable 真 Enumerable 偽 Configurable 真 O を返します。
プロトタイプオブジェクト [40] DOMExceptionプロトタイプオブジェクトDOMException prototype object オブジェクト でなければなりません >>34 JavaScriptオブジェクト Prototype %ErrorPrototype% クラス文字列 DOMExceptionPrototype constructor 特性 JavaScript特性 名前 constructor Value DOMException構築子オブジェクト Writable 真 Enumerable 偽 Configurable 真
[48] DOMExceptionプロトタイプオブジェクト初期オブジェクト です。
[41] 更に、エラー名表 の各定数について、次のような特性 がなければなりません >>34 JavaScript特性 名前 エラー名表 の定数 名Value エラー名表 の定数 値Writable 偽 Enumerable 真 Configurable 偽
Web IDL 通常オブジェクト時代 [65] 2017年year:2017 、実装状況に合わせる形で、
Web IDL 仕様書 の本文で規定される
JavaScriptオブジェクト という形から、 Web IDL インターフェイス へと変更されました。
[63] Re-align DOMException objects with what is implemented (#378)
(domenic 著, 2017-07-03 03:33:16 +09:00 )
https://github.com/heycam/webidl/commit/5c8eb310ef7a6bcb3c4813e9791212ee1624f2d3
[76] DOMException function definition makes no sense · Issue #55 · heycam/webidl
(2017-08-21 22:34:07 +09:00 )
https://github.com/heycam/webidl/issues/55
[77] DOMException function definition makes no sense · Issue #55 · heycam/webidl
(2017-08-21 22:39:34 +09:00 )
https://github.com/heycam/webidl/issues/55
[78] Re-align DOMException objects with what is implemented by domenic · Pull Request #378 · heycam/webidl
(2017-08-21 22:39:58 +09:00 )
https://github.com/heycam/webidl/pull/378
[79] Remove DOMException terminal from the grammar
(domenic 著, 2017-07-20 04:42:48 +09:00 )
https://github.com/heycam/webidl/commit/b0855366cc78001725b26ec5c9096c9d3a101f62
[80] Remove DOMException terminal from the grammar by domenic · Pull Request #385 · heycam/webidl
(2017-08-21 22:49:10 +09:00 )
https://github.com/heycam/webidl/pull/385
[105] Use `DOMException` instead of `Error` in `SensorErrorEvent`
(pozdnyakov 著, 2017-10-11 22:42:19 +09:00 )
https://github.com/w3c/sensors/commit/810d1a9b646585d954f4798e227cbf218a2ff9eb
[107] Editorial: use "exception name" DOMException notation
(tobie 著, 2017-10-12 18:35:25 +09:00 )
https://github.com/whatwg/dom/commit/9d83a6406bc57a7deeb5c0831c388bae752f2e5e
[108] Editorial: use "exception name" DOMException notation by tobie · Pull Request #518 · whatwg/dom
(2017-10-14 12:29:48 +09:00 )
https://github.com/whatwg/dom/pull/518
[120] Editorial: cleanup exception terminology
(annevk 著, 2018-04-10 23:37:38 +09:00 )
https://github.com/whatwg/xhr/commit/4b7915e396bbdf3ae39495740c581556e4020eaf
[121] Editorial: use "{{ExceptionType!!exception}}" {{DOMException}} throughout · Issue #173 · whatwg/xhr
(2018-04-11 12:15:33 +09:00 )
https://github.com/whatwg/xhr/issues/173
[122] Editorial: cleanup exception terminology by annevk · Pull Request #195 · whatwg/xhr
(2018-04-11 12:15:38 +09:00 )
https://github.com/whatwg/xhr/pull/195
[123] Clarify note about DOMException
(Ms2ger 著, 2019-05-20 16:46:10 +09:00 )
https://github.com/heycam/webidl/commit/4ef350963f4b9ef5246b2bc420d8bab8ed7b6282
[124] Remove the Error IDL type by Ms2ger · Pull Request #728 · heycam/webidl
(2019-12-25 11:57:57 +09:00 )
https://github.com/heycam/webidl/pull/728
[125] Remove DOMException conversion section
(Ms2ger 著, 2019-05-17 23:03:00 +09:00 )
https://github.com/heycam/webidl/commit/ff88ac4876d747a2ae3ad553f42525927bde4605
[126] Remove the Error IDL type by Ms2ger · Pull Request #728 · heycam/webidl
(2020-01-12 14:13:33 +09:00 )
https://github.com/heycam/webidl/pull/728
[127] Remove the 'exception types' definition
(Ms2ger 著, 2019-05-17 23:21:01 +09:00 )
https://github.com/heycam/webidl/commit/faaee577b0c0c03338b139754835ac999de507be
[128] Use new syntax for DOMException. (#780)
(Ms2ger 著, 2019-08-29 23:21:42 +09:00 )
https://github.com/heycam/webidl/commit/21ffd9bd979bbebc99d1b7ed28c4f56b7c02b018
[129] Use new syntax for DOMException. by Ms2ger · Pull Request #780 · heycam/webidl
(2020-01-12 17:10:17 +09:00 )
https://github.com/heycam/webidl/pull/780
[130] Revert "Use new syntax for DOMException. (#780)"
(bzbarsky 著, 2019-08-30 00:25:08 +09:00 )
https://github.com/heycam/webidl/commit/182b487c128bce00e62431f19458c15fe91e9738
[131] Revert "Use new syntax for DOMException." by bzbarsky · Pull Request #781 · heycam/webidl
(2020-01-12 17:14:15 +09:00 )
https://github.com/heycam/webidl/pull/781
[135] Remove use of [ Constructor] extended attribute
(clelland 著, 2019-09-22 04:35:33 +09:00 )
https://github.com/heycam/webidl/commit/9e514c9dcfb09919af971931409aa075451804a5
[136] Remove use of [ Constructor] extended attribute by clelland · Pull Request #798 · heycam/webidl
(2020-05-14 14:26:13 +09:00 )
https://github.com/heycam/webidl/pull/798
[137] Copy the DOM XPath interfaces from the WHATWG wiki by foolip · Pull Request #763 · whatwg/dom
(2020-07-14 15:20:34 +09:00 )
https://github.com/whatwg/dom/pull/763
[138] Mark DOMException as serializable by yutakahirano · Pull Request #732 · heycam/webidl
(2021-04-12T06:51:33.000Z )
https://github.com/heycam/webidl/pull/732
[139] Make DOMException serializable
(yutakahirano , 2019-07-04 00:04:17 +09:00 , 2021-04-12T07:08:52.000Z )
https://github.com/heycam/webidl/commit/f23ef42038a1d6af6ba19806c8246673711ee7ca
[140] Define serialization and deserialization steps for DOMException · Issue #729 · heycam/webidl
(2021-04-12T07:10:37.000Z )
https://github.com/heycam/webidl/issues/729
[141] Mark DOMException as serializable by yutakahirano · Pull Request #732 · heycam/webidl
(2021-04-12T07:11:59.000Z )
https://github.com/heycam/webidl/pull/732