DrissionPageはウェブ自動化、スクレイピング、テストのための優れたツールである。この記事ではChromiumPageの機能を簡潔に紹介している。
完全なドキュメントはDrissionPageのドキュメントで確認できる。
目次
- インストール
- ChromiumPageオブジェクトの作成
- 基本的な使い方
- 高度な使い方
- 一般的なシナリオの処理
- ページ情報
- ファイルアップロード
- タブ管理
- iFrame処理
- イベントリスナー
- ブラウザアクション
- 画面操作
- ブラウザオプション
インストール
ChromiumPageを使用する前に、pipを使用してDrissionPageライブラリをインストールする：
pip install drissionpage
ChromiumPageオブジェクトの作成
ChromiumPageオブジェクトを作成することが、その機能を使用するための最初のステップ：
from drission_page import ChromiumPage
# ChromiumPageオブジェクトを作成
page = ChromiumPage()
Chromium実行ファイルを指定したり、オプションを追加したりすることも可能：
page = ChromiumPage(executable_path='/path/to/chromium', options=['--headless'])
基本的な使い方
ウェブページを開く
page.get('https://www.example.com')
要素の操作
要素の取得
element = page.get_ele('div.content')
要素情報の取得
text = element.text
attribute = element.attr('class')
要素のクリック
element.click()
要素へのテキスト入力
element.input('text')
高度な使い方
フレームとiFrameの処理
frame = page.switch_to_frame('iframe_name_or_id')
frame.locate('button#inside_frame').click()
page.switch_to_parent_frame()
JavaScriptの実行
result = page.run_js('return document.title')
print(result)
スクリーンショットの撮影
page.screenshot('screenshot.png')
Cookieの管理
cookies = page.get_cookies()
print(cookies)
page.set_cookie({'name': 'test', 'value': '1234'})
page.delete_cookie('test')
一般的なシナリオの処理
ポップアップとアラートの処理
page.accept_alert()
page.dismiss_alert()
要素の待機
要素が表示されるのを待つ
from drission_page import wait_for
wait_for(page.get_ele('div.content').is_visible, timeout=10)
要素がクリック可能になるのを待つ
wait_for(page.get_ele('button#submit').is_clickable, timeout=10)
前後のページに移動
page.back()
page.forward()
ページ情報
ページの訪問
page.visit('https://www.example.com')
ページ情報の取得
title = page.title
url = page.url
html = page.html
ページ操作
ページのリロード
page.reload()
ページの保存
page.save_screenshot('screenshot.png')
page.save_html('page.html')
ファイルアップロード
ファイルのアップロード
file_input = page.get_ele('input[type="file"]')
file_input.upload('/path/to/file')
タブ管理
新しいタブを開く
page.new_tab('https://www.example.com')
タブ間の切り替え
page.switch_tab(1) # 最初のタブに切り替え
タブを閉じる
page.close_tab(1) # 最初のタブを閉じる
iFrame処理
iFrameへの切り替え
frame = page.switch_to_frame('iframe_id')
frame.locate('button#inside_frame').click()
page.switch_to_parent_frame()
iFrame内の要素を探す
iframe = page.get_ele('iframe#iframe_id')
frame_page = page.switch_to_frame(iframe)
frame_element = frame_page.get_ele('div.content')
イベントリスナー
イベントリスナーの追加
page.add_listener('click', 'button#submit', callback_function)
def callback_function(event):
print(f'ボタンがクリックされました: {event}')
イベントリスナーの削除
page.remove_listener('click', 'button#submit')
ブラウザアクション
マウスアクション
element = page.get_ele('button#submit')
page.mouse.move_to(element)
page.mouse.click(element)
キーボードアクション
page.keyboard.type('Hello, World!')
page.keyboard.press('Enter')
画面操作
フルスクリーンモード
page.full_screen()
フルスクリーンモードの終了
page.exit_full_screen()
ブラウザオプション
ブラウザオプションの設定
options = {
'headless': True,
'disable_gpu': True,
'no_sandbox': True
}
page = ChromiumPage(options=options)
ブラウザ設定の変更
page.set_window_size(1920, 1080)
page.set_user_agent('MyCustomUserAgent/1.0')