FileViewer¶

public class FileViewer extends AbstractView ¶

Added in version 1.2.1.

Просмотрщик файлов - область экрана, отображающая содержимое файла внутри iframe’а.

Содержимое iframe’а доступно для чтения только для документов, загруженных с того же origin (в том числе через blob-URL); для сторонних документов браузер запрещает доступ к телу документа.

Constructors¶

FileViewer¶

public FileViewer(Frame parent, WebElement webElement)¶

Methods¶

documentBodyText¶

public String documentBodyText()¶

Added in version 1.2.1.

Метод возвращает текст тела документа, отображаемого в iframe’е просмотрщика.

Для пустого просмотрщика (документ не загружен, about:blank) возвращается пустая строка. Метод читает «мгновенный» снимок: во время подмены документа возможны транзиентные WebDriver-исключения — при опросе в цикле их следует трактовать как «содержимое ещё не готово» (см. waitDocumentBodyText(java.lang.String, java.time.Duration)).

Returns:: текст тела документа

wait¶

public static FileViewer wait(Frame parent)¶

Added in version 1.2.1.

Метод выполняет ожидание html-элемента, соответствующего FileViewer, в дереве html-элементов браузера.

Parameters:

parent – родительский фрейм

Returns:

Просмотрщик файлов

waitDocumentBodyText¶

public void waitDocumentBodyText(String expectedText, Duration timeout)¶

Added in version 1.2.1.

Метод ожидает, пока текст тела документа в просмотрщике не станет равен ожидаемому.

Дожидается стабилизации асинхронной загрузки документа: содержимое iframe’а меняется по мере прихода ответов на запросы файла, поэтому одиночное чтение может увидеть промежуточное состояние. Транзиентные WebDriver-исключения в момент подмены документа трактуются как «ещё не готово».

Parameters:

expectedText – ожидаемый текст тела документа
timeout – максимальное время ожидания

Throws:

AutomationException – если за отведённое время ожидаемый текст не появился