From 5adc2aaffc5c4005336f668844fe7e010ef014bf Mon Sep 17 00:00:00 2001
From: Leonid Vinogradov <win.leon@protonmail.com>
Date: Sun, 2 Jun 2024 00:46:04 +0300
Subject: [PATCH] [ru] update `Web/API/Document/images` translation (#20483)

* [ru] update 'Web/API/Document/images' translation

* [ru] update 'l10n.sourceCommit' front matter key
---
 files/ru/web/api/document/images/index.md | 38 ++++++++++++-----------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/files/ru/web/api/document/images/index.md b/files/ru/web/api/document/images/index.md
index 2ce55c9876c1ff..24e5242af7fc22 100644
--- a/files/ru/web/api/document/images/index.md
+++ b/files/ru/web/api/document/images/index.md
@@ -1,37 +1,39 @@
 ---
-title: document.images
+title: "Document: свойство images"
 slug: Web/API/Document/images
+l10n:
+  sourceCommit: 0af9a589170f1535622062de89bbf73507580b8f
 ---
 
-{{ ApiRef() }}
+{{APIRef("DOM")}}
 
-### Кратко об объекте
+Доступное только для чтения свойство **`images`** интерфейса {{domxref("Document")}} возвращает [коллекцию](/ru/docs/Web/API/HTMLCollection) всех [изображений](/ru/docs/Web/API/HTMLImageElement) HTML-документа.
 
-`document.images` возвращает коллекцию [изображений](/ru/Web/API/HTMLImageElement) в текущем HTML документе.
+## Значение
 
-### Синтаксис
+{{domxref("HTMLCollection")}} со всеми изображениями, которые содержит текущий документ. Каждая запись в коллекции является {{domxref("HTMLImageElement")}} и представляет отдельный элемент изображения.
 
-```js
-var htmlCollection = document.images;
-```
+## Примечания по использованию
 
-### Пример
+Для доступа к элементам коллекции можно использовать нотацию массивов или метод {{domxref("HTMLCollection.item", "item()")}}. Следующие действия эквивалентны:
 
 ```js
-var images = document.images;
+firstImage = imageCollection.item(0);
 
-for (var i = 0; i < images.length; i++) {
-  if (images[i].src == "banner.gif") {
-    alert("Баннер найден!");
-  }
-}
+firstImage = imageCollection[0];
 ```
 
-### Примечания
+## Примеры
 
-`document.images.length` — возвращает количество изображений на странице.
+В этом примере в документе происходит поиск изображений с именем `"banner.gif"`.
 
-`document.images` является частью DOM HTML, и работает только в HTML документах.
+```js
+for (const image of document.images) {
+  if (image.src === "banner.gif") {
+    console.log("Найден баннер");
+  }
+}
+```
 
 ## Спецификации