Повертає HTMLCollection елементів із зазначеним ім'ям тега. Пошук здійснюється по всьому документу, включаючи кореневий вузол. Повертається HTMLCollection жива, це означає що вона автоматично оновлює сама себе щоб залишатися синхронізованою з DOM деревом без необхідності виклику document.getElementByTagName () знову.
- elements це жива HTMLCollection (з урахуванням примітки внизу) знайдених документів в такому порядку в якому вони з'являються в дереві.
- name рядок представляє собою ім'я елемента. Спеціальна рядок "*" дозволяє отримати всі елементи.
Примітка: Остання W3C специфікація каже що elements є HTMLCollection; між тим, даний метод повертає NodeList в WebKit браузерах. Див. Помилка 14869 для більшої інформації.
У наступному прикладі, getElementByTagName () стартує з окремого батьківського елемента і шукає зверху-вниз рекурсивно по DOM починаючи з батьківського елемента переглядаючи дочірні елементи на відповідність тегів параметру name.
Відзначимо що коли вузол в якому getElementsByTagName () був викликаний не є вузлом document. за фактом використовується метод element.getElementsByTagName ().
Примітки
Коли викликається на HTML document, getElementsByTagName () переводить в нижній регістр свій аргумент перед роботою. Це може бути несподіваним при спробі знайти відповідність для camelCase SVG елементів в поддереве HTML документа. У такому випадку може бути корисний document.getElementsByTagNameNS (). Див. Також помилка 499656.
document.getElementsByTagName () подібний до element.getElementsByTagName (). за винятком того що пошук охоплює весь документ.