برگشتي متدgetElementByTagName( )شئ HTMLCollectionميباشد .
شئHTMLCollection آرايه ايست كه ليستي از عناصرHTML را شامل ميشود.
مثال ـ در مثال زير ليست همه عناصر<p> يك سند است .
const myCollection = document.getElementsByTagName("p");
عناصر در اين مجموعه با شماره انديس قابل دسترسي هستند .براي دسترسي به دومين عنصر مطابق كد زير:
myCollection[1]
توجه ـ انديس از صفر شروع ميشود.
ويژگيlength تعداد عناصر در شئHTMLCollection را مشخص ميكند.
مثال ـ طول شئ مجموعه
myCollection.length
ويژگيlength شئ مجموعه براي دور زدن روي عناصر شئ مورد استفاده قرار ميگيرد .
مثال ـ تغيير رنگ تمام عناصر<p> سند .
const myCollection = document.getElementsByTagName("p"); for (let i = 0; i < myCollection.length; i++) { myCollection[i].style.color = "red"; }
شئHTMLCollection يك آرايه نيست، اما شبيه به آرايه است .
ميتوان روي آن دور زده وبا شماره به عناصر آن رجوع كرد .دقيقا مشابه آرايه
با اين حال نميتوانيد ازمتدهاي آرايه مانندvalueOf() , pop() , push() , Join() شئHTMLCollection استفاده كنيد .