События clickpath в браузере - История изменений

IKuznetsov: /* Формат локатора DOM */

2025-03-13T15:25:30Z

Формат локатора DOM

← Предыдущая		Версия 15:25, 13 марта 2025
Строка 424:		Строка 424:
	** <code>document</code>		** <code>document</code>
	** <code>'''<u>''[https://developer.mozilla.org/en-US/docs/Web/API/XPathResult XPathResult.*]''</u>'''</code>		** <code>'''<u>''[https://developer.mozilla.org/en-US/docs/Web/API/XPathResult XPathResult.*]''</u>'''</code>
	* Вычисления '''Javascript''' не поддерживаются внутри локаторов '''DOM''' .		{\| class="wikitable"
	* Глобальные переменные '''Javascript''' не поддерживаются внутри локаторов '''DOM''' .		\|document.method("str1")
			document.method('str2', null)

			document.method(undefined, document)

			document.method(XPathResult.ANY_TYPE)
			\|}

			* Вычисления '''Javascript''' не поддерживаются внутри локаторов '''DOM'''.
			{\| class="wikitable"
			\|// Not supported
			document.forms[1+2]
			\|}

			* Глобальные переменные '''Javascript''' не поддерживаются внутри локаторов '''DOM'''.
			{\| class="wikitable"
			\|// Not supported, where someVar is a global variable
			document.querySelector(someVar)
			\|}

IKuznetsov: /* Время ожидания до срабатывания следующего события */

2025-03-13T15:24:45Z

Время ожидания до срабатывания следующего события

← Предыдущая		Версия 15:24, 13 марта 2025
Строка 323:		Строка 323:
	* '''None'''		* '''None'''
	* '''Wait for page to load complete''' — ждет завершения сетевой активности после запуска события загрузки. Это время ожидания по умолчанию (60 секунд), используемое при загрузке новой страницы.		* '''Wait for page to load complete''' — ждет завершения сетевой активности после запуска события загрузки. Это время ожидания по умолчанию (60 секунд), используемое при загрузке новой страницы.
	* '''Wait for specific period of time''' позволяет указать количество секунд, которое ~~Dynatrace~~ должен ждать между данным событием и следующим.		* '''Wait for specific period of time''' позволяет указать количество секунд, которое Ключ-АСТРОМ должен ждать между данным событием и следующим.
	* '''Wait for background network activity to complete''' ожидает завершения всей сетевой активности после события. Это время ожидания по умолчанию, используемое для XHR и взаимодействий в одностраничных приложениях. Эта опция недоступна для событий '''Navigate'''.		* '''Wait for background network activity to complete''' ожидает завершения всей сетевой активности после события. Это время ожидания по умолчанию, используемое для XHR и взаимодействий в одностраничных приложениях. Эта опция недоступна для событий '''Navigate'''.
	* '''Wait for specific element to appear''' позволяет вам ждать определенный элемент '''HTML''' на странице, указав локатор '''CSS''' или '''DOM''' для элемента. Вы также можете указать текст для проверки в элементе и тайм-аут для поиска элемента.		* '''Wait for specific element to appear''' позволяет вам ждать определенный элемент '''HTML''' на странице, указав локатор '''CSS''' или '''DOM''' для элемента. Вы также можете указать текст для проверки в элементе и тайм-аут для поиска элемента.

IKuznetsov в 15:23, 13 марта 2025

2025-03-13T15:23:41Z

← Предыдущая		Версия 15:23, 13 марта 2025
Строка 337:		Строка 337:
	\|}		\|}

	=== ~~Проверить содержание~~ ===		=== Проверка контента ===
	Проверка содержимого помогает проверить, загружает ли ваш браузер ожидаемый контент страницы или элемент. Проверки выполняются с помощью правил проверки: выберите '''Добавить правило проверки содержимого''' , чтобы определить правило проверки.		Проверка содержимого помогает проверить, загружает ли ваш браузер ожидаемый контент страницы или элемент. Проверки выполняются с помощью правил проверки: выберите '''Добавить правило проверки содержимого''' , чтобы определить правило проверки.

Строка 345:		Строка 345:

	Вы можете выполнить проверку на основе определенного текста на веб-странице, определенного элемента, текста, включенного в элемент, или текста в '''DOM''' или любом ресурсе. Вы можете выбрать прохождение или провал вашего монитора/события на основе ваших критериев проверки. Если критерии прохождения не выполнены (или выполнены критерии провала), монитор/событие терпит неудачу и выполнение прерывается.		Вы можете выполнить проверку на основе определенного текста на веб-странице, определенного элемента, текста, включенного в элемент, или текста в '''DOM''' или любом ресурсе. Вы можете выбрать прохождение или провал вашего монитора/события на основе ваших критериев проверки. Если критерии прохождения не выполнены (или выполнены критерии провала), монитор/событие терпит неудачу и выполнение прерывается.

			[[Файл:1209.png\|граница]]

			[[Файл:1211.png\|граница\|604x604пкс]]

			Целевое окно определяет вкладку, в которой находится текст/элемент. <code>window[0]</code> является первой открытой вкладкой , а <code>window[1]</code> представляет вторую вкладку. Также может быть <code>window[N].frames[X]</code> где <code>X</code> является номером <code>iframe</code>, который отображается на странице <code>N</code> в tab. Фреймы также могут быть связаны, <code>window[N].frames[X].frames[Y]</code> что означает, элементы с заданными локаторами находятся внутри рамки <code>Y</code>, которая находится внутри рамки <code>X</code> на вкладке <code>N</code>.

			Вы также можете использовать заполнитель в значении окна «Цель» , например <code>window[0].frames[{index}]</code>, где <code>{index}</code>— переменная, определенная ранее с помощью метода <code>api.setValue()</code> в событии '''JavaScript''' .

			Если ваша проверка основана на '''видимом тексте''' (содержит видимый текст), тексте, найденном в '''определенном элементе''' (содержит текст в элементе), или тексте разметки '''в DOM или ресурсе''' (содержит текст в DOM или любом ресурсе), вам необходимо '''Указать текст''' (без учета регистра). Заключите значения заполнителей в скобки, например, <code>{email}</code>. При желании вы можете указать текст как регулярное выражение.

			Если ваша проверка ищет '''элемент''' (содержит элемент) или текст, найденный в '''определенном элементе''' (содержит текст в элементе), вам необходимо указать селекторы '''CSS''' или локаторы '''DOM''' для использования во время воспроизведения: выберите '''Добавить локатор''' , затем выберите '''DOM''' или '''CSS''' и укажите ссылку на локатор. При вставке строки локатора обязательно удалите все символы <code>></code>.

			Вы можете добавлять и переупорядочивать столько локаторов, сколько захотите. Проверка выполняется в порядке, который вы определяете, пока не будет найден локатор.

			Вы можете добавлять и изменять порядок более одной проверки для события/монитора. Проверка выполняется в порядке, который вы определяете; если какое-либо из правил не выполняется, монитор не выполняется.

			=== Редактировать локаторы элементов ===
			Этот элемент управления доступен в событиях '''Click''' , '''Tap''' , '''Keystroke''' и '''Выбор опции''' .

			Когда одно из вышеперечисленных событий в вашем '''clickpath''' нацелено на определенный элемент на веб-странице, вы можете просматривать и редактировать локаторы элементов в формате '''DOM''' или '''CSS'''. Локаторы помогают Ключ-АСТРОМ идентифицировать элемент во время воспроизведения. Мы можем захватывать несколько локаторов, чтобы убедиться, что элемент найден, даже если некоторые части кода страницы (например, имена или идентификаторы) изменяются. В большинстве случаев мы захватываем локаторы '''CSS'''. Локаторы оцениваются последовательно; если первый локатор не найден, оценивается второй и так далее, пока не будет совпадения.

			Выберите '''Добавить локатор''' , затем выберите '''DOM''' или '''CSS''' и укажите ссылку на локатор. См. '''Формат локатора DOM''' ниже для получения дополнительной информации об указании локаторов '''DOM'''.

			Вы можете добавить столько локаторов, сколько захотите. Вы также можете редактировать или удалять любые существующие локаторы для вашего элемента.

			Целевое окно определяет вкладку, в которой находится текст/элемент. <code>window[0]</code> является первой открытой вкладкой , а <code>window[1]</code> представляет вторую вкладку. Также может быть <code>window[N].frames[X]</code> где <code>X</code> является номером <code>iframe</code>, который отображается на странице <code>N</code> в tab. Фреймы также могут быть связаны, <code>window[N].frames[X].frames[Y]</code> что означает, элементы с заданными локаторами находятся внутри рамки <code>Y</code>, которая находится внутри рамки <code>X</code> на вкладке <code>N</code>.

			Вы также можете использовать заполнитель в значении окна «Цель» , например <code>window[0].frames[{index}]</code> , где <code>{index}</code>— переменная, определенная ранее с помощью метода <code>api.setValue()</code> в событии '''JavaScript'''.

			[[Файл:1212.png\|граница]]

			==== Формат локатора DOM ====
			'''<u>''Ключ-АСТРОМ версии 1.292+''</u>'''

			Вы можете предпочесть настроить расширенные, пользовательские локаторы '''DOM''' для своих элементов. Правила ниже определяют поддерживаемый формат при использовании '''JavaScript''' в локаторах '''DOM''' для доступа к элементам на веб-странице. Эти правила необходимы в связи с переходом '''Key-Astrom Synthetic Recorder''' (расширение браузера Google Chrome) на '''Manifest Version 3''' (MV3), которая является последней итерацией платформы расширений '''Chrome'''.

			* Чтобы идентифицировать элемент , вы можете выполнить одно из следующих действий.
			** Начните локатор DOM с <code>[https://developer.mozilla.org/en-US/docs/Web/API/Document '''<u>''document.''</u>''']</code>

			{\| class="wikitable"
			\|document.forms[0][1].options[0]
			document.getElementById('adminusername')

			document.querySelector("body > div.vf-body-container > div > div > section > flows").shadowRoot.querySelectorAll("#postalTown")[1]
			\|}
			Например, <code>document.getElementById('adminusername')</code>— это способ доступа к элементу по идентификатору элемента; <code>getElementById</code>— это метод <code>document</code>.

			* '''Или'''
			** Используйте допустимое имя глобальной переменной '''JavaScript''' в начале вашего локатора '''DOM''' для прямого доступа к элементу по его идентификатору. Имя переменной должно содержать ссылку на элемент с соответствующим идентификатором. Например, для элемента <code><nowiki><div id="EmailAddress"></div></nowiki></code> можно указать следующий локатор '''DOM'''.

			{\| class="wikitable"
			\|EmailAddress
			\|}

			* Поддерживаются выражения '''XPath''' . '''<u>''[https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate Ваш локатор DOM]''</u>''' , начинающийся с <code>document.</code> может содержать выражение '''XPath''' в параметре метода <code>xpathExpression</code>. В примере ниже выражение '''XPath''' — <code>'''<u>''[https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate evaluate()]''</u>'''</code><code>'//form[@id=\\'ctl00\\']/div[4]/div[3]/span'</code>

			{\| class="wikitable"
			\|document.evaluate('//form[@id=\\'ctl00\\']/div[4]/div[3]/span', document, null, XPathResult.ANY_TYPE, null).iterateNext()
			\|}

			* Локатор '''DOM''' должен представлять собой цепочку (последовательность) вызовов методов, свойств или сигнатур индексов , как показано в примерах ниже.

			{\| class="wikitable"
			\|document.method().method1()
			document.method().prop['2565']

			document.method( 11 , 'erert','123')

			document.getElementById('deviceList').querySelectorAll('a')[0]
			\|}

			* Аргументами вызова метода могут быть любые из следующих; см. примеры ниже.
			** Строки в двойных или одинарных кавычках
			** Числа
			** <code>null</code>
			** <code>undefined</code>
			** <code>document</code>
			** <code>'''<u>''[https://developer.mozilla.org/en-US/docs/Web/API/XPathResult XPathResult.*]''</u>'''</code>
			* Вычисления '''Javascript''' не поддерживаются внутри локаторов '''DOM''' .
			* Глобальные переменные '''Javascript''' не поддерживаются внутри локаторов '''DOM''' .

IKuznetsov: Новая страница: «Когда вы записываете '''clickpath''' в браузере , ваши взаимодействия с вашим веб-приложением ф...»

2025-03-11T19:25:46Z

Новая страница: «Когда вы записываете '''clickpath''' в браузере , ваши взаимодействия с вашим веб-приложением ф...»

Внесённые изменения