在此页

• 句法
• 用法注意事项
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Range.setEnd() method sets the end position of a 范围 to be located at the given offset into the specified node x.Setting the end point above (higher in the document) than the start point will result in a collapsed range with the start and end points both set to the specified end position.

句法

range.setEnd(endNode, endOffset);
					

参数

endNode

节点 inside which the 范围 should end.

endOffset

An integer greater than or equal to zero representing the offset for the end of the 范围 from the start of endNode .

返回值

undefined .

异常

Exceptions are thrown as DOMException objects of the following types:

InvalidNodeTypeError

The node specified by endNode is a doctype node; range endpoints cannot be located inside a doctype node.

IndexSizeError

The value specified by endOffset is either greater than or equal to the length of the node or is less than zero.

用法注意事项

若 endNode 是 节点 类型 文本 , 注释 ，或 CDataSection ，那么 endOffset is the number of characters from the start of endNode . For other 节点 类型， endOffset is the number of child nodes between the start of the endNode .

范例

const range = document.createRange();
const endNode = document.getElementsByTagName('p').item(3);
const endOffset = endNode.childNodes.length;
range.setEnd(endNode, endOffset);
						

setEnd() is commonly used in conjunction with setStart() to fully configure a range.

规范

规范	状态	注释
DOM The definition of 'Range.setEnd()' in that specification.	实时标准	无变化。
Document Object Model (DOM) Level 2 Traversal and Range Specification The definition of 'Range.setEnd()' in that specification.	过时	最初的规范。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
setEnd	Chrome Yes	Edge 12	Firefox 4	IE 9	Opera 9	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持

完整支持

另请参阅

• The DOM interfaces index

元数据

• 最后修改： Sep 20, 2019

相关话题

1. DOM (文档对象模型)
2. 范围
3. 构造函数

   1. Range()
4. 特性

   1. collapsed
   2. commonAncestorContainer
   3. endContainer
   4. endOffset
   5. startContainer
   6. startOffset
5. 方法

   1. cloneContents()
   2. cloneRange()
   3. collapse()
   4. compareBoundaryPoints()
   5. compareNode()
   6. comparePoint()
   7. createContextualFragment()
   8. deleteContents()
   9. detach()
   10. extractContents()
   11. getBoundingClientRect()
   12. getClientRects()
   13. insertNode()
   14. intersectsNode()
   15. isPointInRange()
   16. selectNode()
   17. selectNodeContents()
   18. setEnd()
   19. setEndAfter()
   20. setEndBefore()
   21. setStart()
   22. setStartAfter()
   23. setStartBefore()
   24. surroundContents()
   25. toString()
6. 继承：

   1. AbstractRange
7. DOM 相关页面

   1. AbortController
   2. AbortSignal
   3. AbstractRange
   4. Attr
   5. ByteString
   6. CDATASection
   7. CSSPrimitiveValue
   8. CSSValue
   9. CSSValueList
   10. CharacterData
   11. ChildNode
   12. 注释
   13. CustomEvent
   14. DOMConfiguration
   15. DOMError
   16. DOMErrorHandler
   17. DOMException
   18. DOMImplementation
   19. DOMImplementationList
   20. DOMImplementationRegistry
   21. DOMImplementationSource
   22. DOMLocator
   23. DOMObject
   24. DOMParser
   25. DOMPoint
   26. DOMPointInit
   27. DOMPointReadOnly
   28. DOMRect
   29. DOMString
   30. DOMTimeStamp
   31. DOMTokenList
   32. DOMUserData
   33. Document
   34. DocumentFragment
   35. DocumentType
   36. 元素
   37. ElementTraversal
   38. Entity
   39. EntityReference
   40. 事件
   41. EventTarget
   42. HTMLCollection
   43. MutationObserver
   44. 节点
   45. NodeFilter
   46. NodeIterator
   47. NodeList
   48. NonDocumentTypeChildNode
   49. ProcessingInstruction
   50. PromiseResolver
   51. StaticRange
   52. 文本
   53. TextDecoder
   54. TextEncoder
   55. TimeRanges
   56. TreeWalker
   57. TypeInfo
   58. USVString
   59. UserDataHandler
   60. XMLDocument