W3C DOM异常对象DOMException介绍

这篇文章发布于 2012年05月14日，星期一，20:00，归类于 JS相关。 阅读 225698 次, 今日 10 次 33 条评论

 

by zhangxinxu from http://www.zhangxinxu.com
本文地址：http://www.zhangxinxu.com/wordpress/?p=2396

最近用jqmobi折腾个小项目，由于框架本身一起其他使用原因，连续遇到DOMException 12以及DOMException 7错误。查阅各个资料，发现国内几乎没有相关比较系统的文章。为方便他人以及自己查找匹对，故这里整理一篇小文。

本文内容整理参考自：SitePoint > Reference > JAVASCRIPT > DOM Core > DOMException

一、DOMException是？

DOMException是W3C DOM核心对象。DOMException接口表示一个处理的错误，当一个操作不可能执行的时候，会抛出一个异常。例如试图创建一个无效的DOM, 或通过一个不存在的节点作为参数节点操作方法。

举个板栗，如下代码：
var node = document.getElementsByTagName('h1').item(0);
var refnode = node.nextSibling;
var newnode = document.createTextNode('这就是为何你挂了！');
node.insertBefore(newnode, refnode);

上面代码演示了一个会嗝屁的insertBefore操作，因为refnode不是一个子节点。在Opera浏览器下，上面的操作就会导致下面显示的异常错误：

Inline script thread
Error:
Unhandled Exception: [Object DOMException]
code: 8
message: NOT_FOUND_ERR

DOM并不对每个可能发生的错误定义一个异常，例如参数、语法错误就不在其中，这种情况有其自己的一套错误报告机制来处理。

实际上，大多数浏览器已经把DOM异常作为本地机制。除了显示异常代码和信息外，还显示了浏览器可以提供的其他信息（如行数或堆栈轨迹）

二、DOM Exceptions兼容性

兼容性见下表：

Internet Explorer Firefox Safari Opera
5.5 6.0 7.0 1.5 2.0 3.0 1.3 2.0 3.0 9.0 9.5

上表的兼容性数据还是比较老的，按照常规，IE9也应该支持的，最新的Chrome浏览器一定支持。

考古价值的IE浏览器不支持该接口，他们使用本地错误（解析错误之类）。例如，上面插入节点的例子，在老IE下抛出的就是：Invalid argument. 在XML中，会给出更多的信息：Insert position Node must be a Child of the Node to insert under.

三、常量列表

该接口定义了ExceptionCode整数值——向外暴露code属性——指向每种类型的错误；这些定义参考下面些常量：

INDEX_SIZE_ERR code 1
如果索引是负值，或是超过了允许值。例如splitText的offset参数比字符串长度还要长。
DOMSTRING_SIZE_ERR code 2
DOMString的特定字符数据太大。其大小显示是依赖实现的，未被DOM定义（每个浏览器的限制细节参见DOM Core）。
HIERARCHY_REQUEST_ERR code 3
节点不允许有新的子节点，或者新节点已经是其该节点的祖先节点。例如，尝试将Element节点塞入Text节点。
WRONG_DOCUMENT_ERR code 4
试图使用跨文档的节点操作。例如，appendChild的子节点来自其他文档。而不是先输出(使用importNode)。
INVALID_CHARACTER_ERR code 5
一个非法的或无效的字符指定一个有限制的字符串，例如元素的name.
NO_DATA_ALLOWED_ERR code 6
为不支持数据的节点指定数据。如Element节点本身不包含数据，其子节点包含。
NO_MODIFICATION_ALLOWED_ERR code 7
试图修改一个不能被修改的节点。例如，装载一个只读的节点。
NOT_FOUND_ERR code 8
引用的节点不存在。例如，insertBefore相关子节点不是引用的子节点。
NOT_SUPPORTED_ERR code 9
实现不支持的特定操作。例如使用一个节点的方法，但是此方法并没有实现，就是抛出此错误。
INUSE_ATTRIBUTE_ERR code 10
试图添加一个正在使用的属性。例如使用setAttributeNode引用一个已经在另一个元素使用的Attr, 而不是克隆它首先(使用cloneNode)。
INVALID_STATE_ERR code 11
试图使用一个不可用的对象。这种错误的抛出通常是因为某些内部原因，方法无法实现特定的操作。
SYNTAX_ERR code 12
无效或非法的字符串被指定。例如，用无效的CSS值设置selectorText属性的CSSStyleRule. //zxx: 我遇到该错误是因为在特定情况下，对<title>标签使用了innerHTML方法。
INVALID_MODIFICATION_ERR code 13
尝试修改一个节点的类型。例如，使用不匹配最初规则类型的值设置cssText属性的CSSRule.(如，为at-rule设置style-rule values值).
NAMESPACE_ERR code 14
操作与命名空间冲突。例如createElementNS使用的名称歪瓜裂枣。
INVALID_ACCESS_ERR code 15
一个属性或操作不支持指定的节点。例如，尝试在一个不含float值的CSS属性上使用getFloatValue的CSSPrimitiveValue方法。

关于code:ExceptionCode(也就是上面列表中一而再再而三的code)的整数值表示DOMException的类型。

四、最后的说明

本文内容没什么看头。重要的记住这里有篇关于DOMException的文章即可，回头可以迅速找到就OK啦！上面展示的列表中对ExceptionCode不同值的解释太泛太笼统了，后面的举例感觉是要故意展示一些方法，属性等。因此，离自己所希望的人人进来，人人都有启发的愿景还是有一定差距的。DOMException的各个错误也是不容易碰到的，但是，一旦碰到是很头疼的，整个页面的JS基本上就会报废，而且，错误不易查找。例如，使用数字作为元素id，在某些特定情况下，某些浏览器下，就会报DOMException的错误。

我现在比以前懒的，要是过去，刚毕业那会，激情无限的时候，估计会废寝忘食把每个错误都呈现一遍。现在嘛，唉，搞不动了，而且，错误呈现实在不易。因此，抱歉，大家只能将就上面一些笼统泛泛的解释了吧。

不过嘛，团结才是力量，本文可以无限评论的。因此，您要是遇到DOMException错误，并因为这里或那里解决了，记得一定要把您遇到的错误code、具体情境以及解决方法。以评论或邮件(zhangxinxu@zhangxinxu.com)的形式告知，我一定会整理出现，放在正文中的。这样，集思广益，细流成海，以后，一旦遇到浏览器报DOMException的错误，来这里就可以搞定，岂不很好。

因此，希望本文可以成为一个解决DOMException错误的一个平台，收集各个同行的经验，造福自己以及其他同行；而不仅仅是个普通文章。想法是美好的，具体就要看您的贡献与支持了！一起努力吧！

本文为原创文章，转载请注明来自张鑫旭-鑫空间-鑫生活[http://www.zhangxinxu.com]
本文地址：http://www.zhangxinxu.com/wordpress/?p=2396

（本篇完）

相关文章
«上一篇
下一篇»
分享到：
标签： , , ,


发表评论（目前33 条评论）

  1. ZhangSy说道：
    2019年01月16日 14:06

    我遇到的是iOS9系统中，post接口报错：SyntaxError: DOM Exception 12，
    查了DOM文档一直在找css方面的原因，
    后来才发现是给Content-Type赋值的时候，前面多打了一个空格

    回复
  2. 八月说道：
    2018年10月11日 17:29

    如果code是18呢

    回复
  3. 丢丢说道：
    2018年09月17日 14:32

    react项目遇到这个情况

    回复
    • 丢丢说道：
      2018年09月17日 14:36

      Uncaught DOMException: Failed to execute ‘createElement’ on ‘Document’: The tag name provided

      回复
  4. 无畏说道：
    2018年09月5日 11:25

    使用数字id报错chrome

    回复
  5. lalala说道：
    2017年04月25日 14:01

    一个页面镶嵌了一个跨域的iframe，window.frames[0]可以取到，但是取其中的值时，Uncaught [object DOMException]。
    具体原因不明，有见过的么。。

    回复
    • lalala说道：
      2017年04月25日 14:01

      Uncaught DOMException: Blocked a frame with origin “http://localhost” from accessing a cross-origin frame.
      at Error (native)
      at :2:17
      at Object.InjectedScript._evaluateOn (:875:140)
      at Object.InjectedScript._evaluateAndWrap (:808:34)
      at Object.InjectedScript.evaluate (:664:21)

      回复
  6. 扎西说道：
    2017年03月3日 10:53

    有一个iframe的内容是会改变的，需要在打开页面的时候获得iframe的内容高度来设置iframe的高度，我是等iframe onload的时这样$(“#comment”).contents().find(“body”).height()获取高度的。有时候会报错，报错如下，请问这是什么原因，有什么解决方案？在此先感谢

    Uncaught DOMException: Failed to read the ‘contentDocument’ property from ‘HTMLIFrameElement’: Blocked a frame with origin “http://qy.iwgame.com” from accessing a cross-origin frame.

    回复
  7. Nocti说道：
    2017年02月10日 16:24

    微信web开发者工具 偶尔会出现这个问题
    undefined:1 Uncaught (in promise) DOMException: Failed to load because no supported source was found.
    问题复现方法：直接使用 .play 方法播放不支持的格式的音频
    一些浏览器容器在 load 完成之前使用 play 方法播放就会报这个错
    （一般都是因为load的音频格式不支持）
    目前没有解决方案 电脑的开发者工具上失败之后在手机上通常不会出错 出错的时候重启微信/手机即可 就是客服妹子要麻烦点了

    回复
  8. 张浅说道：
    2016年11月30日 11:12

    HTML5 new Worker(URL)的时候，出错了：VM580:2 Uncaught DOMException: Failed to construct ‘Worker’: Script at cannot be accessed from origin ‘null’.
    at Error (native)
    at :2:1
    at Object.InjectedScript._evaluateOn (:878:140)
    at Object.InjectedScript._evaluateAndWrap (:811:34)
    at Object.InjectedScript.evaluate (:667:21)
    为什么要这样

    回复
  9. 贡献一枚说道：
    2016年09月13日 15:39

    Uncaught (in promise) DOMException: The play() request was interrupted by a call to pause().
    通过new Audio(file)的方式加载音效，一个音效在播放，突然play别的音效，就会报这个错。表示很无赖，查这个http://stackoverflow.com/questions/37136077/how-do-i-prevent-the-error-uncaught-in-promise-domexception-the-play-reque也解决不了，鑫大能否指点指点？

    回复
    • alpha说道：
      2016年10月10日 14:49

      视频没有加载出来的时候，点击视频播放，谷歌浏览器就会报这个错误。我也遇到了

      回复
    • Kk说道：
      2017年02月21日 16:21

      我也遇到了点击视频的时候报The play() request was interrupted by a call to pause()这种错误，不知道怎么解决

      回复
    • symfony说道：
      2017年02月22日 21:01

      解决了没？我也遇到了

      回复
    • symfony说道：
      2017年02月22日 21:12

      我解决了
      if(video.buffered.end(0) < GetQueryString("playtime"))//GetQueryString("playtime")是当前点击位置，或者说是当前要跳转的位置
      alert("还没加载到这里，请耐心等待…");
      else{
      video.currentTime = GetQueryString("playtime");//已经加载到此处再设置currentTime
      }

      回复
  10. sylvana说道：
    2014年03月3日 14:20

    通过百度搜索结果点击进入的页面，window.opener为什么是”DOMException”呢？请指点一下

    回复
  11. 路过支持了！说道：
    2012年09月25日 11:24

    路过支持了！

    回复
  12. 才两个小时就有56次访问了说道：
    2012年05月14日 22:49

    才两个小时就有56次访问了

    回复
  13. pubu说道：
    2012年05月14日 20:44

    路过支持了！

    回复