Skip to content

Commit c41ff02

Browse files
mdmintzmdmintz
committed
Update the docs
1 parent c45a512 commit c41ff02

File tree

4 files changed

+67
-55
lines changed

4 files changed

+67
-55
lines changed

‎examples/cdp_mode/ReadMe/index.html

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2788,7 +2788,13 @@ <h1>🐙 CDP Mode</h1>
27882788
<!-- SeleniumBase Docs -->
27892789

27902790
<h2 id="cdp-mode"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="32"></a> CDP Mode 🐙<a class="headerlink" href="#cdp-mode" title="Permanent link">&para;</a></h2>
2791-
<p>🐙 <b translate="no">SeleniumBase</b> <b translate="no">CDP Mode</b> (Chrome Devtools Protocol Mode) is a special mode inside of <b><a href="../../help_docs/uc_mode.md" translate="no"><span translate="no">SeleniumBase UC Mode</span></a></b> that lets bots appear human while controlling the browser with the <b translate="no">CDP-Driver</b>. Although regular <span translate="no">UC Mode</span> can't perform <span translate="no">WebDriver</span> actions while the <code>driver</code> is disconnected from the browser, the <span translate="no">CDP-Driver</span> can still perform actions while maintaining its cover. (For Python 3.11 or newer!)</p>
2791+
<p>🐙 <b translate="no">SeleniumBase</b> <b translate="no">CDP Mode</b> (Chrome Devtools Protocol Mode) is a special mode inside of <b><a href="../../help_docs/uc_mode.md" translate="no"><span translate="no">SeleniumBase UC Mode</span></a></b> that lets bots appear human while controlling the browser with the <b translate="no">CDP-Driver</b>. Although regular <span translate="no">UC Mode</span> can't perform <span translate="no">WebDriver</span> actions while the <code>driver</code> is disconnected from the browser, the <span translate="no">CDP-Driver</span> can still perform actions while maintaining its cover.</p>
2792+
<hr />
2793+
<!-- YouTube View -->
2794+
<p><a href="https://www.youtube.com/watch?v=Mr90iQmNsKM"></a></p>
2795+
<p><img src="http://img.youtube.com/vi/Mr90iQmNsKM/0.jpg" title="SeleniumBase on YouTube" width="366" /><p>(<b><a href="https://www.youtube.com/watch?v=Mr90iQmNsKM">Watch the CDP Mode tutorial on YouTube! ▶️</a></b>)</p>
2796+
</p>
2797+
<hr />
27922798
<p>👤 <b translate="no">UC Mode</b> avoids bot-detection by first disconnecting WebDriver from the browser at strategic times, calling special <code>PyAutoGUI</code> methods to bypass CAPTCHAs (as needed), and finally reconnecting the <code>driver</code> afterwards so that WebDriver actions can be performed again. Although this approach works for bypassing simple CAPTCHAs, more flexibility is needed for bypassing bot-detection on websites with advanced protection. (That's where <b translate="no">CDP Mode</b> comes in.)</p>
27932799
<p>🐙 <b translate="no">CDP Mode</b> is based on <a href="https://github.com/HyperionGray/python-chrome-devtools-protocol" translate="no">python-cdp</a>, <a href="https://github.com/HyperionGray/trio-chrome-devtools-protocol" translate="no">trio-cdp</a>, and <a href="https://github.com/ultrafunkamsterdam/nodriver" translate="no">nodriver</a>. <code>trio-cdp</code> is an early implementation of <code>python-cdp</code>, and <code>nodriver</code> is a modern implementation of <code>python-cdp</code>. (Refactored Python-CDP code is imported from <a href="https://github.com/mdmintz/MyCDP" translate="no">MyCDP</a>.)</p>
27942800
<p>🐙 <b translate="no">CDP Mode</b> includes multiple updates to the above, such as:</p>
@@ -3177,6 +3183,8 @@ <h3 id="cdp-mode-api-methods">🐙 CDP Mode API / Methods<a class="headerlink" h
31773183
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">assert_url_contains</span><span class="p">(</span><span class="n">substring</span><span class="p">)</span>
31783184
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">assert_text</span><span class="p">(</span><span class="n">text</span><span class="p">,</span> <span class="n">selector</span><span class="o">=</span><span class="s2">&quot;html&quot;</span><span class="p">)</span>
31793185
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">assert_exact_text</span><span class="p">(</span><span class="n">text</span><span class="p">,</span> <span class="n">selector</span><span class="o">=</span><span class="s2">&quot;html&quot;</span><span class="p">)</span>
3186+
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">assert_true</span><span class="p">()</span>
3187+
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">assert_false</span><span class="p">()</span>
31803188
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">scroll_into_view</span><span class="p">(</span><span class="n">selector</span><span class="p">)</span>
31813189
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">scroll_to_y</span><span class="p">(</span><span class="n">y</span><span class="p">)</span>
31823190
<span class="n">sb</span><span class="o">.</span><span class="n">cdp</span><span class="o">.</span><span class="n">scroll_to_top</span><span class="p">()</span>

‎help_docs/uc_mode/index.html

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2698,6 +2698,10 @@ <h4 id="for-the-successor-to-default-uc-mode-see-cdp-mode">(For the successor to
26982698
<figure class="wp-block-embed wp-block-embed-youtube is-type-video is-provider-youtube"><div class="wp-block-embed__wrapper"><div class="epyt-video-wrapper fluid-width-video-wrapper" style="padding-top: 3px !important;"><iframe loading="lazy" id="_ytid_36718" data-origwidth="1200" data-origheight="675" src="https://www.youtube.com/embed/-EpZlhGWo9k?enablejsapi=1&amp;origin=https://seleniumbase.io&amp;autoplay=0&amp;cc_load_policy=0&amp;cc_lang_pref=&amp;iv_load_policy=1&amp;loop=0&amp;modestbranding=1&amp;rel=0&amp;fs=1&amp;playsinline=0&amp;autohide=2&amp;theme=dark&amp;color=red&amp;controls=1&amp;" class="__youtube_prefs__ no-lazyload" title="YouTube player" allow="autoplay; encrypted-media" allowfullscreen="" data-no-lazy="1" data-skipgform_ajax_framebjll=""></iframe></div></div></figure>
26992699
<p>(<b><a href="https://www.youtube.com/watch?v=-EpZlhGWo9k">Watch the 3rd UC Mode tutorial on YouTube! ▶️</a></b>)</p>
27002700

2701+
<hr />
2702+
<figure class="wp-block-embed wp-block-embed-youtube is-type-video is-provider-youtube"><div class="wp-block-embed__wrapper"><div class="epyt-video-wrapper fluid-width-video-wrapper" style="padding-top: 3px !important;"><iframe loading="lazy" id="_ytid_36718" data-origwidth="1200" data-origheight="675" src="https://www.youtube.com/embed/Mr90iQmNsKM?enablejsapi=1&amp;origin=https://seleniumbase.io&amp;autoplay=0&amp;cc_load_policy=0&amp;cc_lang_pref=&amp;iv_load_policy=1&amp;loop=0&amp;modestbranding=1&amp;rel=0&amp;fs=1&amp;playsinline=0&amp;autohide=2&amp;theme=dark&amp;color=red&amp;controls=1&amp;" class="__youtube_prefs__ no-lazyload" title="YouTube player" allow="autoplay; encrypted-media" allowfullscreen="" data-no-lazy="1" data-skipgform_ajax_framebjll=""></iframe></div></div></figure>
2703+
<p>(<b><a href="https://www.youtube.com/watch?v=Mr90iQmNsKM">Watch the 4th UC Mode tutorial on YouTube! ▶️</a></b>)</p>
2704+
27012705
<hr />
27022706
<p>👤 <b translate="no">UC Mode</b> is based on <a href="https://github.com/ultrafunkamsterdam/undetected-chromedriver">undetected-chromedriver</a>. <span translate="no">UC Mode</span> includes multiple updates, fixes, and improvements, such as:</p>
27032707
<ul>

‎search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎sitemap.xml

Lines changed: 53 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -2,214 +2,214 @@
22
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
33
<url>
44
<loc>https://seleniumbase.io/</loc>
5-
<lastmod>2024-11-26</lastmod>
5+
<lastmod>2024-11-28</lastmod>
66
</url>
77
<url>
88
<loc>https://seleniumbase.io/examples/ReadMe/</loc>
9-
<lastmod>2024-11-26</lastmod>
9+
<lastmod>2024-11-28</lastmod>
1010
</url>
1111
<url>
1212
<loc>https://seleniumbase.io/examples/case_summary/</loc>
13-
<lastmod>2024-11-26</lastmod>
13+
<lastmod>2024-11-28</lastmod>
1414
</url>
1515
<url>
1616
<loc>https://seleniumbase.io/examples/behave_bdd/ReadMe/</loc>
17-
<lastmod>2024-11-26</lastmod>
17+
<lastmod>2024-11-28</lastmod>
1818
</url>
1919
<url>
2020
<loc>https://seleniumbase.io/examples/cdp_mode/ReadMe/</loc>
21-
<lastmod>2024-11-26</lastmod>
21+
<lastmod>2024-11-28</lastmod>
2222
</url>
2323
<url>
2424
<loc>https://seleniumbase.io/examples/chart_maker/ReadMe/</loc>
25-
<lastmod>2024-11-26</lastmod>
25+
<lastmod>2024-11-28</lastmod>
2626
</url>
2727
<url>
2828
<loc>https://seleniumbase.io/examples/dialog_boxes/ReadMe/</loc>
29-
<lastmod>2024-11-26</lastmod>
29+
<lastmod>2024-11-28</lastmod>
3030
</url>
3131
<url>
3232
<loc>https://seleniumbase.io/examples/example_logs/ReadMe/</loc>
33-
<lastmod>2024-11-26</lastmod>
33+
<lastmod>2024-11-28</lastmod>
3434
</url>
3535
<url>
3636
<loc>https://seleniumbase.io/examples/master_qa/ReadMe/</loc>
37-
<lastmod>2024-11-26</lastmod>
37+
<lastmod>2024-11-28</lastmod>
3838
</url>
3939
<url>
4040
<loc>https://seleniumbase.io/examples/presenter/ReadMe/</loc>
41-
<lastmod>2024-11-26</lastmod>
41+
<lastmod>2024-11-28</lastmod>
4242
</url>
4343
<url>
4444
<loc>https://seleniumbase.io/examples/tour_examples/ReadMe/</loc>
45-
<lastmod>2024-11-26</lastmod>
45+
<lastmod>2024-11-28</lastmod>
4646
</url>
4747
<url>
4848
<loc>https://seleniumbase.io/examples/visual_testing/ReadMe/</loc>
49-
<lastmod>2024-11-26</lastmod>
49+
<lastmod>2024-11-28</lastmod>
5050
</url>
5151
<url>
5252
<loc>https://seleniumbase.io/help_docs/ReadMe/</loc>
53-
<lastmod>2024-11-26</lastmod>
53+
<lastmod>2024-11-28</lastmod>
5454
</url>
5555
<url>
5656
<loc>https://seleniumbase.io/help_docs/behave_gui/</loc>
57-
<lastmod>2024-11-26</lastmod>
57+
<lastmod>2024-11-28</lastmod>
5858
</url>
5959
<url>
6060
<loc>https://seleniumbase.io/help_docs/case_plans/</loc>
61-
<lastmod>2024-11-26</lastmod>
61+
<lastmod>2024-11-28</lastmod>
6262
</url>
6363
<url>
6464
<loc>https://seleniumbase.io/help_docs/chinese/</loc>
65-
<lastmod>2024-11-26</lastmod>
65+
<lastmod>2024-11-28</lastmod>
6666
</url>
6767
<url>
6868
<loc>https://seleniumbase.io/help_docs/commander/</loc>
69-
<lastmod>2024-11-26</lastmod>
69+
<lastmod>2024-11-28</lastmod>
7070
</url>
7171
<url>
7272
<loc>https://seleniumbase.io/help_docs/customizing_test_runs/</loc>
73-
<lastmod>2024-11-26</lastmod>
73+
<lastmod>2024-11-28</lastmod>
7474
</url>
7575
<url>
7676
<loc>https://seleniumbase.io/help_docs/demo_mode/</loc>
77-
<lastmod>2024-11-26</lastmod>
77+
<lastmod>2024-11-28</lastmod>
7878
</url>
7979
<url>
8080
<loc>https://seleniumbase.io/help_docs/desired_capabilities/</loc>
81-
<lastmod>2024-11-26</lastmod>
81+
<lastmod>2024-11-28</lastmod>
8282
</url>
8383
<url>
8484
<loc>https://seleniumbase.io/help_docs/features_list/</loc>
85-
<lastmod>2024-11-26</lastmod>
85+
<lastmod>2024-11-28</lastmod>
8686
</url>
8787
<url>
8888
<loc>https://seleniumbase.io/help_docs/handling_iframes/</loc>
89-
<lastmod>2024-11-26</lastmod>
89+
<lastmod>2024-11-28</lastmod>
9090
</url>
9191
<url>
9292
<loc>https://seleniumbase.io/help_docs/happy_customers/</loc>
93-
<lastmod>2024-11-26</lastmod>
93+
<lastmod>2024-11-28</lastmod>
9494
</url>
9595
<url>
9696
<loc>https://seleniumbase.io/help_docs/hidden_files_info/</loc>
97-
<lastmod>2024-11-26</lastmod>
97+
<lastmod>2024-11-28</lastmod>
9898
</url>
9999
<url>
100100
<loc>https://seleniumbase.io/help_docs/how_it_works/</loc>
101-
<lastmod>2024-11-26</lastmod>
101+
<lastmod>2024-11-28</lastmod>
102102
</url>
103103
<url>
104104
<loc>https://seleniumbase.io/help_docs/html_inspector/</loc>
105-
<lastmod>2024-11-26</lastmod>
105+
<lastmod>2024-11-28</lastmod>
106106
</url>
107107
<url>
108108
<loc>https://seleniumbase.io/help_docs/install/</loc>
109-
<lastmod>2024-11-26</lastmod>
109+
<lastmod>2024-11-28</lastmod>
110110
</url>
111111
<url>
112112
<loc>https://seleniumbase.io/help_docs/install_python_pip_git/</loc>
113-
<lastmod>2024-11-26</lastmod>
113+
<lastmod>2024-11-28</lastmod>
114114
</url>
115115
<url>
116116
<loc>https://seleniumbase.io/help_docs/js_package_manager/</loc>
117-
<lastmod>2024-11-26</lastmod>
117+
<lastmod>2024-11-28</lastmod>
118118
</url>
119119
<url>
120120
<loc>https://seleniumbase.io/help_docs/locale_codes/</loc>
121-
<lastmod>2024-11-26</lastmod>
121+
<lastmod>2024-11-28</lastmod>
122122
</url>
123123
<url>
124124
<loc>https://seleniumbase.io/help_docs/method_summary/</loc>
125-
<lastmod>2024-11-26</lastmod>
125+
<lastmod>2024-11-28</lastmod>
126126
</url>
127127
<url>
128128
<loc>https://seleniumbase.io/help_docs/mobile_testing/</loc>
129-
<lastmod>2024-11-26</lastmod>
129+
<lastmod>2024-11-28</lastmod>
130130
</url>
131131
<url>
132132
<loc>https://seleniumbase.io/help_docs/mysql_installation/</loc>
133-
<lastmod>2024-11-26</lastmod>
133+
<lastmod>2024-11-28</lastmod>
134134
</url>
135135
<url>
136136
<loc>https://seleniumbase.io/help_docs/recorder_mode/</loc>
137-
<lastmod>2024-11-26</lastmod>
137+
<lastmod>2024-11-28</lastmod>
138138
</url>
139139
<url>
140140
<loc>https://seleniumbase.io/help_docs/shadow_dom/</loc>
141-
<lastmod>2024-11-26</lastmod>
141+
<lastmod>2024-11-28</lastmod>
142142
</url>
143143
<url>
144144
<loc>https://seleniumbase.io/help_docs/syntax_formats/</loc>
145-
<lastmod>2024-11-26</lastmod>
145+
<lastmod>2024-11-28</lastmod>
146146
</url>
147147
<url>
148148
<loc>https://seleniumbase.io/help_docs/thank_you/</loc>
149-
<lastmod>2024-11-26</lastmod>
149+
<lastmod>2024-11-28</lastmod>
150150
</url>
151151
<url>
152152
<loc>https://seleniumbase.io/help_docs/translations/</loc>
153-
<lastmod>2024-11-26</lastmod>
153+
<lastmod>2024-11-28</lastmod>
154154
</url>
155155
<url>
156156
<loc>https://seleniumbase.io/help_docs/uc_mode/</loc>
157-
<lastmod>2024-11-26</lastmod>
157+
<lastmod>2024-11-28</lastmod>
158158
</url>
159159
<url>
160160
<loc>https://seleniumbase.io/help_docs/useful_grep_commands/</loc>
161-
<lastmod>2024-11-26</lastmod>
161+
<lastmod>2024-11-28</lastmod>
162162
</url>
163163
<url>
164164
<loc>https://seleniumbase.io/help_docs/using_safari_driver/</loc>
165-
<lastmod>2024-11-26</lastmod>
165+
<lastmod>2024-11-28</lastmod>
166166
</url>
167167
<url>
168168
<loc>https://seleniumbase.io/help_docs/verify_webdriver/</loc>
169-
<lastmod>2024-11-26</lastmod>
169+
<lastmod>2024-11-28</lastmod>
170170
</url>
171171
<url>
172172
<loc>https://seleniumbase.io/help_docs/virtualenv_instructions/</loc>
173-
<lastmod>2024-11-26</lastmod>
173+
<lastmod>2024-11-28</lastmod>
174174
</url>
175175
<url>
176176
<loc>https://seleniumbase.io/help_docs/webdriver_installation/</loc>
177-
<lastmod>2024-11-26</lastmod>
177+
<lastmod>2024-11-28</lastmod>
178178
</url>
179179
<url>
180180
<loc>https://seleniumbase.io/integrations/azure/azure_pipelines/ReadMe/</loc>
181-
<lastmod>2024-11-26</lastmod>
181+
<lastmod>2024-11-28</lastmod>
182182
</url>
183183
<url>
184184
<loc>https://seleniumbase.io/integrations/azure/jenkins/ReadMe/</loc>
185-
<lastmod>2024-11-26</lastmod>
185+
<lastmod>2024-11-28</lastmod>
186186
</url>
187187
<url>
188188
<loc>https://seleniumbase.io/integrations/docker/ReadMe/</loc>
189-
<lastmod>2024-11-26</lastmod>
189+
<lastmod>2024-11-28</lastmod>
190190
</url>
191191
<url>
192192
<loc>https://seleniumbase.io/integrations/github/workflows/ReadMe/</loc>
193-
<lastmod>2024-11-26</lastmod>
193+
<lastmod>2024-11-28</lastmod>
194194
</url>
195195
<url>
196196
<loc>https://seleniumbase.io/integrations/google_cloud/ReadMe/</loc>
197-
<lastmod>2024-11-26</lastmod>
197+
<lastmod>2024-11-28</lastmod>
198198
</url>
199199
<url>
200200
<loc>https://seleniumbase.io/seleniumbase/common/ReadMe/</loc>
201-
<lastmod>2024-11-26</lastmod>
201+
<lastmod>2024-11-28</lastmod>
202202
</url>
203203
<url>
204204
<loc>https://seleniumbase.io/seleniumbase/console_scripts/ReadMe/</loc>
205-
<lastmod>2024-11-26</lastmod>
205+
<lastmod>2024-11-28</lastmod>
206206
</url>
207207
<url>
208208
<loc>https://seleniumbase.io/seleniumbase/masterqa/ReadMe/</loc>
209-
<lastmod>2024-11-26</lastmod>
209+
<lastmod>2024-11-28</lastmod>
210210
</url>
211211
<url>
212212
<loc>https://seleniumbase.io/seleniumbase/utilities/selenium_grid/ReadMe/</loc>
213-
<lastmod>2024-11-26</lastmod>
213+
<lastmod>2024-11-28</lastmod>
214214
</url>
215215
</urlset>

0 commit comments

Comments
 (0)