screenshot_by_number($file_path,$number,$frame=-1,$as_gray=false)
Данная команда используется для создания скриншота элемента страницы, находя
его по заданному номеру.
Команда на вход принимает параметры:
-
$file_path - путь к файлу, в который
будет сохранен скриншот элемента. По умолчанию формат скриншота - jpeg.
Также поддерживаются следующие форматы файла скриншота (задаются по
расширению файла) bmp,gif,png. Путь к файлу может быть как полный (с
указанием диска) так и относительный, в этом случае переданный путь будет
добавлен к папке в которой находится php файл запущенного скрипта.
-
$number - номер по которому мы
находим необходимый нам элемент на странице (int) . Номера элементов
начинаются с 0 и для элементов разного типа своя нумерация. Чтобы узнать
номер элемента, можно воспользоваться либо инспектором элементов, либо
контекстным меню, либо посмотреть его в списке элементов.
-
$as_gray - указывает делать скриншот
в сером цвете (true)
-
$frame - номер фрейма, в котором мы
ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 -
элемент находится не во фрейме. Номер фрейма в котором находится нужный вам
элемент можно узнать из инспектора задач, контекстного меню и панели списка
элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой
же самый, передается строка с номерами фреймов, разделенных : например при
передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером
0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет
произведен поиск фрейма, который содержит заданный src, или передавать
"name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки команда возвращает результат своей работы в робот:
-
true - выполнили успешно
-
false - найти такой
элемент не удалось (например нет вообще элементов, удовлетворяющих заданным
критериям или нет такого фрейма)