Почему справка от mozilla сделана так "неорректно"

[Andy_kun]

Подскажите, у меня вот такой вопрос:

Для примера привожу описание метода Node.childNodes c mozilla: https://developer.mozilla.org/en-US/...ode/childNodes

The read-only childNodes property of the Node interface returns a live NodeList of child nodes of the given element where the first child node is assigned index 0. Child nodes include elements, text and comments.

Доступное только для чтения childNodes свойство Node-интерфейса возвращает в реальном времени NodeList дочерний nodes-элемент данного элемента, где первому дочернему узлу присваивается индекс 0. Дочерние узлы включают элементы, текст и комментарии.

Вот почему тут написано, какие типы Нод возвращает метод - "элементы, текст и комментарии"

А вот к примеру тут: Node.firstChild: https://developer.mozilla.org/ru/doc...ode/firstChild

Нету:

The read-only firstChild property of the Node interface returns the node's first child in the tree, or null if the node has no children.

If the node is a Document, this property returns the first node in the list of its direct children.

Как вот понимать, какого типа Ноды возвращает к примеру метод Node.firstChild ?

[Aetae]

Ну потому что это очевидно. DOM документ состоит из узлов (node), соответственно всё что возвращается - node и есть. А уж элемент или текст - дело десятое.

[Andy_kun]

Ну потому что это очевидно. DOM документ состоит из узлов (node), соответственно всё что возвращается - node и есть. А уж элемент или текст - дело десятое.

Но у разных типов Node - есть разные методы же.
Да и к тому же - зачем тогда писать про элемент или текст. Тогда уж или писать или нет.

[Aetae]

Захотелось вот и написали. Теоретически это даже не корректно, потому что в некоторых случаях там могут оказаться и иные типы node.

MDN - оно поддерживается сообществом, т.е. более-менее как wikipedia. Если тебе нужны железные стандартизированные документы - читай спецификации.

[Andy_kun]

Понял. Спасибо.