Perlゼミ

send_keys_to_active_element

入力1:

<div>必須:</div><div>{配列 | 文字列} - Array of strings or a string.</div><div></div>

<b>使用方法:</b>
<pre>
$driver->send_keys_to_active_element('abcd', 'efg');
$driver->send_keys_to_active_element('hijk');<div></div><div>or</div><div></div><div># include the WDKeys module</div><div>use <a href="/pod/Selenium::Remote::WDKeys">Selenium::Remote::WDKeys</a>;
$driver->send_keys_to_active_element(KEYS->{'space'}, KEYS->{'enter'});

send_keys_to_alert

send_keys_to_promptと同義

send_keys_to_prompt

入力:

$driver->general_action( actions => [{

WebDriver3対応のセレニウムサーバーでのみ使用できます。

以前にmouse_move_to_location（）などのレガシーシムを呼び出したことがある場合、渡されたアクションは既存のアクションキューに追加されます。引数なしで呼び出され、既存のアクションキューを実行するだけです。

現在Selenium::Remote::Driverの一部ではないプリベークされたアクションチェーンを探している場合は、代わりにこのディストリビューションに付属しているSelenium::ActionChainsを検討してください。

release_general_action

軌道から*すべて*の入力デバイス状態（修飾キーの上下、ポインターボタンの上下、ポインターの位置、およびその他のデバイスの状態）を削除します。提供されたアクションチェーンで* Upイベントを実行するのを忘れた場合、または単に時間を節約するために電話してください。

また、現在のアクションキューをクリアします。

WebDriver3対応のセレニウムサーバーでのみ使用できます。

mouse_move_to_location

出力:

使用方法:

<div># element - the element to move to. If not specified or is null, the offset is relative to current position of the mouse.</div><div># xoffset - X offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.</div><div># yoffset - Y offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.</div><div></div><div>print $driver->mouse_move_to_location(element =&gt; e, xoffset =&gt; x, yoffset =&gt; y);

move_to

mouse_move_to_locationと同義

get_capabilities

出力:

使用方法:

<div>my $capab = $driver->get_capabilities();<div>print Dumper($capab);

get_timeouts

使用方法:

$driver->get_timeouts();

set_timeout

入力:

使用方法:

$driver->set_timeout('script', 1000);

set_async_script_timeout

入力:

使用方法:

$driver->set_async_script_timeout(1000);

set_implicit_wait_timeout

入力:

出力:

使用方法:

$driver->set_implicit_wait_timeout(10);

pause

使用方法:

$driver->pause(10000); # 10 second delay</div>$driver->pause(); # 1 second delay default</div><div></div><div>DEPRECATED: consider using Time::HiRes instead.</div>

close

使用方法:

$driver->close();<div>or</div><div>#close a popup window</div><div>my $handles = $driver->get_window_handles;
$driver->switch_to_window($handles->[1]);
$driver->close();
$driver->switch_to_window($handles->[0]);

quit

使用方法:

$driver->quit();

get_current_window_handle

出力:

使用方法:

<div>print $driver->get_current_window_handle();

get_window_handles

出力:

使用方法:

<div>print Dumper $driver->get_window_handles;<div>or</div><div># get popup, close, then back</div><div>my $handles = $driver->get_window_handles;
$driver->switch_to_window($handles->[1]);
$driver->close;
$driver->switch_to_window($handles->[0]);

get_window_size

入力:

出力:

使用方法:

<div>my $window_size = $driver->get_window_size();<div>print $window_size->{'height'}, $window_size->{'width'};

get_window_position

入力:

出力:

使用方法:

<div>my $window_size = $driver->get_window_position();<div>print $window_size->{'x'}, $window_size->('y');

get_current_url

出力:

使用方法:

<div>print $driver->get_current_url();

navigate

入力:

使用方法:

$driver->navigate('<a href="http://www.google.com">http://www.google.com</a>');

get

入力:

使用方法:

$driver->get('<a href="http://www.google.com">http://www.google.com</a>');

get_title

出力:

使用方法:

<div>print $driver->get_title();

go_back

使用方法:

$driver->go_back();

go_forward

使用方法:

$driver->go_forward();

refresh

使用方法:

$driver->refresh();

has_javascript

使用方法:

<div>if ($driver->has_javascript) { ...; }</div>

execute_async_script

出力:

使用方法:

<div>my $script = q{</div><div>var arg1 = arguments[0];<div>var callback = arguments[arguments.length-1];<div>var elem = window.document.findElementById(arg1);<div>callback(elem);<div>};<div>my $elem = $driver->execute_async_script($script,'myid');<div>$elem->click;

execute_script

出力:

使用方法:

<div>my $script = q{</div><div>var arg1 = arguments[0];<div>var elem = window.document.findElementById(arg1);<div>return elem;<div>};<div>my $elem = $driver->execute_script($script,'myid');<div>$elem->click;

screenshot

出力:

使用方法:

<div>print $driver->screenshot();<div>print $driver->screenshot({'full' =&gt; 1});

スクリーンショットをファイルに簡単に書き込むには、「capture_screenshot」を参照してください。

capture_screenshot

出力:

使用方法:

$driver->capture_screenshot($filename);
$driver->capture_screenshot($filename, {'full' => 1});

available_engines

出力:

使用方法:

<div>print Dumper $driver->available_engines;

switch_to_frame

入力1:

<div>必須:</div><div>{文字列 | NUMBER | NULL | WebElement} - ID of the frame which can be one of the three</div><div>mentioned.</div><div></div>

<b>使用方法:</b>
<pre>
$driver->switch_to_frame('frame_1');<div>or</div>$driver->switch_to_frame($driver->find_element('iframe', 'tag_name'));

switch_to_parent_frame

Webdriver 3は、引数なしでswitch_to_frameを呼び出すのと同じです（例:NULLフレーム）。その場合、これは実際に呼び出されます。現在、WD3対応サーバーを使用していると仮定します。

switch_to_window

入力1:

<div>必須:</div><div>文字列 - Window handle or the Window name</div><div></div>

<b>使用方法:</b>
<pre>
$driver->switch_to_window('MY Homepage');<div>or</div><div># close a popup window and switch back</div><div>my $handles = $driver->get_window_handles;
$driver->switch_to_window($handles->[1]);
$driver->close;
$driver->switch_to_window($handles->[0]);

set_window_position

入力:

出力:

使用方法:

$driver->set_window_position(50, 50);

set_window_size

入力:

出力:

使用方法:

$driver->set_window_size(640, 480);

maximum_window

入力:

出力:

使用方法:

$driver->maximize_window();

minimize_window

出力:

使用方法:

$driver->minimize_window();

fullscreen_window

出力:

使用方法:

$driver->fullscreen_window();

get_all_cookies

出力:

使用方法:

<div>print Dumper($driver->get_all_cookies());

add_cookie

使用方法:

$driver->add_cookie('foo', 'bar', '/', '.google.com', 0, 1)</div>

delete_all_cookies

使用方法:

$driver->delete_all_cookies();

get_cookie_named

基本的に、指定された名前のCookieのみを取得します。*本当に*長いリストを期待しない限り、リストからそれを選択することをお勧めします。

<b>入力:</b>
<div>Cookie Name - 文字列</div>

get_all_cookies（）;の要素と同様に、Cookie定義ハッシュを返します。

Compatibility:
Only available on webdriver3 enabled selenium servers.

delete_cookie_named

入力1:

<div>必須:</div><div>文字列 - name of cookie to delete</div><div></div>

<b>使用方法:</b>
<pre>
$driver->delete_cookie_named('foo');

get_page_source

出力:

使用方法:

<div>print $driver->get_page_source();

find_element

ドキュメントルートから始めて、ページ上の要素を検索します。見つかった要素は、WebElementオブジェクトとして返されます。要素が見つからない場合は、CROAKを実行して、スクリプトを強制終了します。代わりに警告が必要な場合は、パラメーター化されたバージョンのファインダーを使用してください。

find_element_by_class

find_element_by_class_name

find_element_by_css

find_element_by_id

find_element_by_link

find_element_by_link_text

find_element_by_name

find_element_by_partial_link_text

find_element_by_tag_name

find_element_by_xpathThese

これらの関数はすべて、単一の文字列引数を取ります。つまり、必要な要素のロケーター検索ターゲットです。要素が見つかった場合、WebElementを受け取ります。それ以外の場合は、0を返します。0でメソッドを呼び出すと、もちろんスクリプトが強制終了されることに注意してください。

入力:

2つ (1つは任意)

必須:

文字列 - 検索ターゲット.

任意:

文字列 - 要素の検索に使用するロケータースキーム、使用可能なスキーム:

{class, class_name, css, id, link, link_text, partial_link_text, tag_name, name, xpath}

インスタンス化するときに中にグローバルに設定されていない場合、デフォルトは「xpath」です。

出力:

Selenium::Remote::WebElement - WebElement Object

これはwebelement_classが設定されている場合は、Selenium::Remote::WebElementのサブクラスである可能性があります。

使用方法:

$driver->find_element("//input[\@name='q']");

find_elements

ドキュメントルートから始めて、ページ上の複数の要素を検索します。見つかった要素は、WebElementオブジェクトの配列として返されます。

入力:

2つ (1つは任意)

必須:

文字列 - 検索ターゲット.

任意:

文字列 - 要素の検索に使用するロケータースキーム、使用可能なスキーム:

{class, class_name, css, id, link, link_text, partial_link_text, tag_name, name, xpath}

インスタンス化するときに中にグローバルに設定されていない場合、デフォルトは「xpath」です。

出力:

複数のWebElementオブジェクトを含んだ<配列|配列リファレンス>

使用方法:

$driver->find_elements("//input");

find_child_element

Search for an element on the page, starting from the identified element. Thelocated element will be returned as a WebElement object.Input: 3 (1 optional)必須:Selenium::Remote::WebElement - WebElement object from where you want tostart searching.文字列 - The search target. (Do not use a double whack('//')in an xpath to search for a child elementex: '//option[@]'instead use a dot whack ('./')ex: './option[@]')Optional:文字列 - Locator scheme to use to search the element, available schemes:{class, class_name, css, id, link, link_text, partial_link_text,tag_name, name, xpath}Defaults to 'xpath' if not configured global during instantiation.

出力:

WebElement Object

使用方法:

my $elem1 = $driver->find_element("//select[\@name='ned']");# note the usage of ./ when searching for a child element instead of //my $child = $driver->find_child_element($elem1, "./option[\@value='es_ar']");

find_child_elements

Search for multiple element on the page, starting from the identifiedelement. The located elements will be returned as an array of WebElementobjects.Input: 3 (1 optional)必須:Selenium::Remote::WebElement - WebElement object from where you want tostart searching.文字列 - The search target.Optional:文字列 - Locator scheme to use to search the element, available schemes:{class, class_name, css, id, link, link_text, partial_link_text,tag_name, name, xpath}Defaults to 'xpath' if not configured global during instantiation.

出力:

配列 of WebElement Objects.

使用方法:

my $elem1 = $driver->find_element("//select[\@name='ned']");# note the usage of ./ when searching for a child element instead of //my $child = $driver->find_child_elements($elem1, "./option");

find_element_by_class

「find_element」を参照してください。

find_element_by_class_name

「find_element」を参照してください。

find_element_by_css

「find_element」を参照してください。

find_element_by_id

「find_element」を参照してください。

find_element_by_link

「find_element」を参照してください。

find_element_by_link_text

「find_element」を参照してください。

find_element_by_name

「find_element」を参照してください。

find_element_by_partial_link_text

「find_element」を参照してください。

find_element_by_tag_name

「find_element」を参照してください。

find_element_by_xpath

「find_element」を参照してください。

get_active_element

現在フォーカスがあるページ上の要素を取得します。検索された要素はWebElementオブジェクトとして返されます。

出力:

WebElementオブジェクト

使用方法:

$driver->get_active_element();

cache_status

Get the status of the html5 application cache.

使用方法:

print $driver->cache_status;

出力:

<number> - Status code for application cache: {UNCACHED = 0, IDLE = 1, CHECKING = 2, DOWNLOADING = 3, UPDATE_READY = 4, OBSOLETE = 5}

set_geolocation

現在の地理的位置を設定する - ドライバーがこのエンドポイントを実装する必要があることに注意してください。少なくとも、それはChromedriverのv2.12で動作します。

入力:

必須:ハッシュ: A hash with key C<location> whose value is a Location hashref. Seeusage section for example.

使用方法:

$driver->set_geolocation( location => {latitude => 40.714353,longitude => -74.005973,altitude => 0.056747});

出力:

ブール値 - 成功あるいは失敗

get_geolocation

現在の地理的位置を取得します。 Webドライバーはこのエンドポイントを実装する必要があることに注意してください。実装しないと、セッションがクラッシュします。リリースの時点では、これをdesktopFirefoxDriverまたはデスクトップChromedriverで動作させることができませんでした。

使用方法:

print $driver->get_geolocation;

出力:

{ latitude: 数値, longitude: 数値, altitude: 数値 } - 現在の地理的位置

get_log

特定のログタイプのログを取得します。ログバッファは、各要求の後にリセットされます。

入力:

必須:<文字列> - 取得するログの種類:{client|driver|browser|server}他にも利用可能な場合があります。seeget_log_typesnのドライバーの完全なリストを表示します。

使用方法:

$driver->get_log( $log_type );

<b>出力:</b>


&lt;配列|配列REF&gt; - An array of log entries since the most recent request.

get_log_types

使用可能なログの種類を取得します。既定では、すべてのドライバーにはクライアント、ドライバー、ブラウザー、およびサーバーの種類が必要ですが、ドライバーによっては、より多くの利用可能ながあります。

使用方法:

my @types = $driver->get_log_types;
$driver->get_log($types[0]);

出力:

set_orientation

ブラウザの方向を設定します。

入力:

必須:<文字列> - 方向 {LANDSCAPE|PORTRAIT}

使用方法:

$driver->set_orientation( $orientation );

出力:

ブール値 - 成功あるいは失敗

get_orientation

現在のブラウザの向きを取得します。LANDSCAPEかPORTRAITを返します。

使用方法:

print $driver->get_orientation;

出力:

<文字列> - 向き.

send_modifier

2 つの要素 ID が同じ DOM 要素を参照しているかどうかをテストします。入力: 2 つの体の付け, :リモート:Web要素 - Web 要素オブジェクトセレン::リモート:Web要素 - Web 要素オブジェクト

使用方法:

$driver->send_modifier('Alt','down');$elem->send_keys('c');
$driver->send_modifier('Alt','up');or$driver->send_modifier('Alt',1);$elem->send_keys('c');
$driver->send_modifier('Alt',0);

compare_elements

2つの要素IDが同じDOM要素を参照しているかどうかをテストします。

Input:

2つ 必須:

Selenium::Remote::WebElement - WebElement Object

Selenium::Remote::WebElement - WebElement Object

出力:

ブール値

使用方法:

$driver->compare_elements($elem_obj1, $elem_obj2);

click

ボタン - 'LEFT'/0 'MIDDLE'/1 'RIGHT'/2デフォルトの'LEFT'キューに1つ - (オプション)クリックを実行するのではなく、キューに入れます。WD3 のみ。

入力:

button - any one of 'LEFT'/0 'MIDDLE'/1 'RIGHT'/2defaults to 'LEFT'queue - (optional) queue the click, rather than executing it. WD3 only.

使用方法:

$driver->click('LEFT');
$driver->click(1); #MIDDLE$driver->click('RIGHT');
$driver->click; #Defaults to left

double_click

現在のマウス座標をダブルクリックします(movetoで設定)。互換性:Webdriver3対応サーバーでは、任意のマウスボタンをダブルクリックすることができます。

使用方法:

$driver->double_click(button);

button_down

マウスの左ボタンをクリックしたままにします(最後の movetoコマンドで設定した座標で)。次に続くマウス関連のコマンドは buttonup です。他のマウスコマンド(ボタンダウンへの別の呼び出しなど)は未定義の動作を生み出します。キューを実行するにはgeneral_action() を呼び出すか、または click() のようなアクションを呼び出す必要があります。

使用方法:

$self->button_down;

button_up

以前に押されていたマウス ボタンを解放します(現在マウスが置かれている場所)。ボタンダウンコマンドが発行されるたびに一度呼び出す必要があります。順序付け切れコマンドの影響に関するクリックとボタンダウンのメモを参照してください。キューを実行するにはgeneral_action() を呼び出すか、または click() のようなアクションを呼び出す必要があります。

使用方法:

$self->button_up;

send_keys

ローカル マシンからセレン サーバーマシンにファイルをアップロードします。そのファイルは、Webフォーム上のファイルアップロードのテストに使用できます。ファイルへのリモート サーバーのパスを返します。ファイル名を超えて引数として生データを渡すと、ファイルの内容ではなく、それをアップロードします。生データを渡すときは、単一のファイルの zip と base64 エンコードバージョンを期待することを知らされます。複数のファイルやディレクトリは、リモート サーバーでサポートされていません。

使用方法:

my $remote_fname = $driver->upload_file( $fname );
my $element = $driver->find_element( '//input[@]' );
$element->send_keys( $remote_fname );

get_text

特定の要素のテキストを取得します。find_element() のラッパー

使用方法:

$text = $driver->get_text("//div[\@name='q']");

get_body

本文全体の現在のテキストを取得します。代わりに生の HTML 全体が必要な場合は、get_page_sourceを参照してください。

使用方法:

$body_text = $driver->get_body();

get_path

現在のブラウザーの場所のパス部分を取得します。

使用方法:

$path = $driver->get_path();

get_user_agent

window.navigator.userAgent のブラウザーの値に従って、ユーザー エージェント文字列を取得する便利なメソッド。

使用方法:

$user_agent = $driver->get_user_agent()

set_inner_window_size

現在のウィンドウを閉じて、新しいウィンドウで現在のページを再び開くことによって、内部ウィンドウのサイズを設定します。これは、ブラウザを使用してモバイル デバイスとしてモックする場合に便利です。インスタンス化中に inner_window_size ハッシュ キー オプションを設定すると、このサブルーチンが自動的に起動されます。

入力:

整数 - ウィンドウの高さとウィンドウの幅を表す整数

出力:

ブール値 - 成功または失敗

使用方法:

$driver->set_inner_window_size(640, 480);

get_local_storage_item

指定されたキーで指定されたローカルストレージ項目の値を取得します。

入力1:

必須:文字列 - 処理されるキーの名前

出力:

文字列 - ローカルストレージ項目の値

使用方法:

$driver->get_local_storage_item('key')

delete_local_storage_item

指定されたキーで指定されたローカルストレージアイテムの値を削除します。

入力1:

必須: 文字列 - 削除するキーの名前

使用方法:

$driver->delete_local_storage_item('key')

関連項目

このモジュールに関連する詳細については、これらのモジュール/ Webサイトを参照してください。

• https://github.com/SeleniumHQ/selenium-メインのセレンRCプロジェクト
• https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol-「レガシー」Webドライバー仕様
• https://www.w3.org/TR/webdriver/-WC3 WebDriver3仕様
• https://github.com/teodesian/Selenium-Remote-Driver/wiki
• ブラウニー
• ワイト

バグ

バグトラッカーのウェブサイトhttps://github.com/teodesian/Selenium-Remote-Driver/issuesでバグや機能のリクエストを報告してください

バグまたはリクエストを送信するときは、バグまたは必要な機能を説明するテストファイルまたは既存のテストファイルへのパッチを含めてください。

著者

現在のメンテナ:

• ダニエルゲンペソー<gempesaw@gmail.com>
• EmmanuelPeroumalnaïk<peroumalnaik.emmanuel@gmail.com>

以前のメンテナ:

• ルーククロス<cpan@5thplane.com>
• マーク・ストスバーグ<mark@stosberg.com>

原作者:

• Aditya Ivaturi <ivaturi@gmail.com>

寄稿者

• アレン・ルー<allen@alew.org>
• A.MacLeay <a.macleay@gmail.com>
• Andy Jack <andyjack@users.noreply.github.com>
• Andy Jack <github@veracity.ca>
• Bas Bloemsaat <bas@bloemsaat.com>
• ブレイクGH <blake@mobiusconsortium.org>
• ブライアンホラク<brianh@zoovy.com>
• チャールズハウズ<charles.howes@globalrelay.net>
• Chris Davies <FMQA@users.noreply.github.com>
• ダニエル・ファックレル<dfackrell@bluehost.com>
• デイブ・ロルスキー<autarch@urth.org>
• Dmitry Karasik <dmitry@karasik.eu.org>
• ダグベル<doug@preaction.me>
• ディラン・ストレブ<dylan.streb@oneil.com>
• エリック・ジョンソン<eric.git@iijo.org>
• ガボール・ザボ<gabor@szabgab.com>
• ジョージS.ボー<george.b@cpanel.net>
• ゲルハルト・ユングワース<gjungwirth@sipwise.com>
• ゴードンチャイルド<gordon@gordonchild.com>
• GreatFlamingFoo <greatflamingfoo@gmail.com>
• Ivan Kurmanov <duraley@gmail.com>
• ジョーヒグトン<draxil@gmail.com>
• Jon Hermansen <jon.hermansen@gmail.com>
• 菅間圭太<sugama@jamadam.com>
• ケン・スワンソン<kswanson@genome.wustl.edu>
• lembark <lembark@wrkhors.com>
• Luke Closs <lukec@users.noreply.github.com>
• マルティン・ギュンナー<martin.gruner@otrs.com>
• Matthew Spahr <matthew.spahr@cpanel.net>
• Max O'Cull <maxattax97@gmail.com>
• Michael Prokop <mprokop@sipwise.com>
• mk654321 <kosmichal@gmail.com>
• Peter Mottram（SysPete）<peter@sysnix.com>
• フィルカニア<phil@vivox.com>
• Phil Mitchell <phil.mitchell@pobox.com>
• Prateek Goyal <prateek.goyal5@gmail.com>
• リチャード・サイラー<richard@weltraumpflege.org>
• ロバート・アッター<utter.robert@gmail.com>
• ルジェ<rouzier@gmail.com>
• 辰巳哲也<ttatsumi@ra2.so-net.ne.jp>
• Tod Hagan <42418406+tod222@users.noreply.github.com>
• トム・ヒューキンス<tom@eborcom.com>
• Vangelis Katsikaros <vangelis@adzuna.com>
• ヴァンゲリスカチカロス<vkatsikaros@gmail.com>
• Vishwanath Janmanchi <jvishwanath@gmail.com>
• ViťasStrádal<vitas@matfyz.cz>
• イヴ・ラヴォワ<ylavoie@yveslavoie.com>

著作権とライセンス

Copyright（c）2010-2011 Aditya Ivaturi、Gordon Child

Copyright（c）2014-2017 Daniel Gempesaw

Apacheライセンスバージョン2.0（「ライセンス」）に基づいてライセンス供与されます。ライセンスに準拠する場合を除き、このファイルを使用することはできません。ライセンスのコピーは、次のURLで入手できます。

http://www.apache.org/licenses/LICENSE-2.0

適用法によって要求されるか、書面で合意されない限り、ライセンスに基づいて配布されるソフトウェアは、明示または黙示を問わず、いかなる種類の保証または条件もなしに、「現状有姿」で配布されます。ライセンスに基づく許可と制限を規定する特定の言語については、ライセンスを参照してください。