View Source ExMobileDevice.WebInspector (exmobiledevice v0.2.1)

Functions for controlling Mobile Safari.

This module provides a means of controlling Safari, without requiring SafariDriver. Starting an instance of this process will create a connection to an automated safari instance, on the specified device.

Example

iex(1)> alias ExMobileDevice.WebInspector
ExMobileDevice.WebInspector
iex(2)> {:ok, pid} = WebInspector.start_supervised("00008120-0018DEADC0DEFACE")
{:ok, #PID<0.208.0>}
iex(3)> {:ok, page} = WebInspector.create_page(pid)
{:ok, "page-7102B011-5BC0-4785-87DF-ADBA671EAD74"}
iex(4)> WebInspector.navigate_to(pid, page, "https://elixir-lang.org")
:ok

Summary

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

close_page(pid, page)

Close the specified page.

create_page(pid)

Create a new automation page.

go_back(pid, page)

Go to the previous url in the page's history.

go_forward(pid, page)

Go to the next url in the page's history.

list_pages(pid)

List the current automation pages.

navigate_to(pid, page, url, opts \\ [])

Navigate the specified page to the provided url.

reload(pid, page)

Reload the page's current url.

set_controlling_process(pid, cp)

Transfer ownership to the specified process.

start_supervised(udid)

Create a supervised connection to the 'webinspector' service on the device.

stop(pid)

Stop the webinspector process.

switch_to_page(pid, page)

Switch to the specified page.

take_screenshot(pid, page)

Take a screenshot of the current page, returning the bytes in PNG format.

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

close_page(pid, page)

@spec close_page(pid(), String.t()) :: :ok | {:error, any()}

Close the specified page.

create_page(pid)

@spec create_page(pid()) :: {:ok, String.t()} | {:error, any()}

Create a new automation page.

go_back(pid, page)

@spec go_back(pid(), String.t()) :: :ok | {:error, any()}

Go to the previous url in the page's history.

go_forward(pid, page)

@spec go_forward(pid(), String.t()) :: :ok | {:error, any()}

Go to the next url in the page's history.

list_pages(pid)

@spec list_pages(pid()) :: {:ok, [map()]} | {:error, any()}

List the current automation pages.

navigate_to(pid, page, url, opts \\ [])

@spec navigate_to(pid(), String.t(), String.t(), Keyword.t()) :: :ok | {:error, any()}

Navigate the specified page to the provided url.

Supported options are:

timeout: The page-load timeout in milliseconds. Defaults to 30_000 (30 seconds)

reload(pid, page)

@spec reload(pid(), String.t()) :: :ok | {:error, any()}

Reload the page's current url.

set_controlling_process(pid, cp)

@spec set_controlling_process(pid(), pid()) :: :ok | {:error, any()}

Transfer ownership to the specified process.

Transfers controlling ownership of pid to cp. The caller must be the current owner.

start_supervised(udid)

@spec start_supervised(String.t()) :: DynamicSupervisor.on_start_child()

Create a supervised connection to the 'webinspector' service on the device.

The connection is supervised by an internal supervision tree of exmobiledevice. To manually stop the connection, call stop/1.

Controlling Process
On success, the caller is the 'controlling process' of the connection. Should the caller exit for any reason, the connection will also exit, which will in turn tear down the automation pages.
To transfer control to another process, call set_controlling_process/2.

stop(pid)

@spec stop(pid()) :: :ok

Stop the webinspector process.

Stopping the process will terminate the connection to the webinspector service on the device, which will remove any automation pages from Safari.

switch_to_page(pid, page)

@spec switch_to_page(pid(), String.t()) :: :ok | {:error, any()}

Switch to the specified page.

take_screenshot(pid, page)

@spec take_screenshot(pid(), String.t()) :: {:ok, binary()} | {:error, any()}

Take a screenshot of the current page, returning the bytes in PNG format.