# @auth0/xmldom 中文文档

规范地址：https://npmcn.com/package/%40auth0/xmldom/

版本：0\.1\.23
npm 元数据更新时间：2026-07-14T10:26:15.896Z
中文译文更新时间：2026-11-07T05:51:30.585Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40auth0/xmldom
原文对照：https://npmcn.com/package/%40auth0/xmldom/?lang=original
项目主页：https://github.com/auth0/xmldom
源码仓库：https://github.com/auth0/xmldom

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：65.3 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=0\.1
- 运行依赖：0 个
- 首次发布：2021-03-01T15:58:29.550Z
- 最新版本发布：2021-03-01T19:25:42.928Z
- 近 30 天下载量：297408（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

W3C标准 XML DOM(Level2 CORE)执行和解析器(DOMParser/XML序列器).

## 安装

```sh
npm install @auth0/xmldom
```

也可以使用：`pnpm add @auth0/xmldom`、`yarn add @auth0/xmldom`、`bun add @auth0/xmldom`

## README

# XMLDOM 数据 [![Build Status](https://secure.travis-ci.org/bigeasy/xmldom.png?branch=master)](http://travis-ci.org/bigeasy/xmldom) [![Coverage Status](https://coveralls.io/repos/bigeasy/xmldom/badge.png?branch=master)](https://coveralls.io/r/bigeasy/xmldom) [![NPM version](https://badge.fury.io/js/xmldom.png)](http://badge.fury.io/js/xmldom)

一个JavaScript为Node.js,Rhino和浏览器执行W3C DOM. 满 兼容 `W3C DOM level2`; 和一些兼容 `level3`支持 `DOMParser` 财务报告和审定财务报表 `XMLSerializer` 界面,例如浏览器.

## 安装 :

> npm 安装 xmldom

# 示例

```javascript
var DOMParser = require('xmldom').DOMParser;
var doc = new DOMParser().parseFromString(
    '<xml xmlns="a" xmlns:c="./lite">\n'+
        '\t<child>test</child>\n'+
        '\t<child></child>\n'+
        '\t<child/>\n'+
    '</xml>'
    ,'text/xml');
doc.documentElement.setAttribute('x','y');
doc.documentElement.setAttributeNS('./lite','c:x','y2');
var nsAttr = doc.documentElement.getAttributeNS('./lite','x')
console.info(nsAttr)
console.info(doc)
```

# API 参考

-   [DOMPARSER 软件](https://developer.mozilla.org/en/DOMParser)数字 :
    
    ```javascript
    parseFromString(xmlsource,mimeType)
    ```
    
    -   **选项扩展** _以 xmldom 为单位_(不是BOM标准!)
    
    ```javascript
    //added the options argument
    new DOMParser(options)
    
    //errorHandler is supported
    new DOMParser({
        /**
         * locator is always need for error position info
         */
        locator:{},
        /**
         * you can override the errorHandler for xml parser
         * @link http://www.saxproject.org/apidoc/org/xml/sax/ErrorHandler.html
         */
        errorHandler:{warning:function(w){console.warn(w)},error:callback,fatalError:callback}
        //only callback model
        //errorHandler:function(level,msg){console.log(level,msg)}
    })
        
    ```
    
-   [XML 序列器](https://developer.mozilla.org/en/XMLSerializer)
    
    ```javascript
    serializeToString(node)
    ```
    

## DOM 级别2 方法和属性 :

-   [节点](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-1950641247)
    
    ```
     attribute:
         nodeValue|prefix
     readonly attribute:
         nodeName|nodeType|parentNode|childNodes|firstChild|lastChild|previousSibling|nextSibling|attributes|ownerDocument|namespaceURI|localName
     method:	
         insertBefore(newChild, refChild)
         replaceChild(newChild, oldChild)
         removeChild(oldChild)
         appendChild(newChild)
         hasChildNodes()
         cloneNode(deep)
         normalize()
         isSupported(feature, version)
         hasAttributes()
    ```
    
-   [DOM 执行](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-102161490)
    
    ```
     method:
         hasFeature(feature, version)
         createDocumentType(qualifiedName, publicId, systemId)
         createDocument(namespaceURI, qualifiedName, doctype)
    ```
    
-   [文档](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#i-Document) : 节点
    
    ```
     readonly attribute:
         doctype|implementation|documentElement
     method:
         createElement(tagName)
         createDocumentFragment()
         createTextNode(data)
         createComment(data)
         createCDATASection(data)
         createProcessingInstruction(target, data)
         createAttribute(name)
         createEntityReference(name)
         getElementsByTagName(tagname)
         importNode(importedNode, deep)
         createElementNS(namespaceURI, qualifiedName)
         createAttributeNS(namespaceURI, qualifiedName)
         getElementsByTagNameNS(namespaceURI, localName)
         getElementById(elementId)
    ```
    
-   [文档碎片](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-B63ED1A3) : 节点
    
-   [元素](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-745549614) : 节点
    
    ```
     readonly attribute:
         tagName
     method:
         getAttribute(name)
         setAttribute(name, value)
         removeAttribute(name)
         getAttributeNode(name)
         setAttributeNode(newAttr)
         removeAttributeNode(oldAttr)
         getElementsByTagName(name)
         getAttributeNS(namespaceURI, localName)
         setAttributeNS(namespaceURI, qualifiedName, value)
         removeAttributeNS(namespaceURI, localName)
         getAttributeNodeNS(namespaceURI, localName)
         setAttributeNodeNS(newAttr)
         getElementsByTagNameNS(namespaceURI, localName)
         hasAttribute(name)
         hasAttributeNS(namespaceURI, localName)
    ```
    
-   [选项](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-637646024) : 节点
    
    ```
     attribute:
         value
     readonly attribute:
         name|specified|ownerElement
    ```
    
-   [节点列表](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-536297177)
    
    ```
     readonly attribute:
         length
     method:
         item(index)
    ```
    
-   [命名了节点映射](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-1780488922)
    
    ```
     readonly attribute:
         length
     method:
         getNamedItem(name)
         setNamedItem(arg)
         removeNamedItem(name)
         item(index)
         getNamedItemNS(namespaceURI, localName)
         setNamedItemNS(arg)
         removeNamedItemNS(namespaceURI, localName)
    ```
    
-   [字符数据](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-FF21A306) : 节点
    
    ```
     method:
         substringData(offset, count)
         appendData(arg)
         insertData(offset, arg)
         deleteData(offset, count)
         replaceData(offset, count, arg)
    ```
    
-   [文本](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-1312295772) 字符数据
    
    ```
     method:
         splitText(offset)
    ```
    
-   [CATA 节](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-667469212)
    
-   [注释](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-1728279322) 字符数据
    
-   [文档类型](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-412266927)
    
    ```
     readonly attribute:
         name|entities|notations|publicId|systemId|internalSubset
    ```
    
-   标记: 节点
    
    ```
     readonly attribute:
         publicId|systemId
    ```
    
-   实体:节点
    
    ```
     readonly attribute:
         publicId|systemId|notationName
    ```
    
-   实体参考:节点
    
-   处理指令 : 节点
    
    ```
     attribute:
         data
     readonly attribute:
         target
    ```
    

## DOM 第3级支助:

-   [节点](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-textContent)
    
    ```
     attribute:
         textContent
     method:
         isDefaultNamespace(namespaceURI){
         lookupNamespaceURI(prefix)
    ```
    

## DOM 扩展为 xmldom

-   \[节点\]源位置扩展;
    
    ```
     attribute:
         //Numbered starting from '1'
         lineNumber
         //Numbered starting from '1'
         columnNumber
    ```

## 常见问题

### @auth0/xmldom 是什么？

W3C标准 XML DOM\(Level2 CORE\)执行和解析器\(DOMParser/XML序列器\)\.

### 如何安装 @auth0/xmldom？

在项目目录运行 npm install @auth0/xmldom，或使用 pnpm add / yarn add / bun add。

### @auth0/xmldom 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/auth0\_\_xmldom 是否存在。

### @auth0/xmldom 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @auth0/xmldom 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=0\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @auth0/xmldom 可以商用吗？

@auth0/xmldom 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @auth0/xmldom 的下载量有多少？

根据 npm 官方下载统计，@auth0/xmldom 在 2026/10/07 – 2026/11/05 这 30 天内被下载 297,408 次，日均约 9,914 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @auth0/xmldom 还在维护吗？

最新版本 0\.1\.23 发布于 2021/03/02（5 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/03/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。