功能

bad_input();
bad_input('缺少搜索词');

blocked();
blocked('显示了登录页面');

let box = bounding_box('.product-list');
// box == {
//   top: 10,
//   right: 800,
//   bottom: 210,
//   left: 200,
//   x: 200,
//   y: 10,
//   width: 600,
//   height: 200,
// }

TBD

click('#show-more');
$('#show-more').click()
// 点击与传入坐标最接近的元素（相对于页面）。
// 例如，点击地图中心的标记
let box = bounding_box('#map')
let center = {x: (box.left+box.right)/2, y: (box.top+box.bottom)/2};
click('.map-pin', {coordinates: center});

close_popup('.popup', '.popup_close');
close_popup('iframe.with-popup', '.popup_close', {click_inside: 'iframe.with-popup'});

collect({price: data.price});
collect(product, p=>{
    if (!p.title)
        throw new Error('产品缺少标题');
})

console.log(1, 'brightdata', [1, 2], {key: value});
console.error(1, 'brightdata', [1, 2], {key: value});

country('us');

dead_page();
dead_page('产品已移除');

detect_block({selector: '.foo'}, {exists: true});
detect_block({selector: '.bar'}, {has_text: 'text'});
detect_block({selector: '.baz'}, {has_text: /regex_pattern/});

disable_event_listeners();
disable_event_listeners(['hover', 'click']);

el_exists('#example'); // => true
el_exists('.does_not_exist'); // => false
el_exists('.does_not_exist', 5e3); // => false（5 秒后）

el_is_visible('#example');
el_is_visible('.is_not_visible', 5e3); // false（5 秒后）

embed_html_comment('trace-id: asdf123');

font_exists('Liberation Mono');

freeze_page();

hover('#item');

html_capture_options({
    coordinate_attributes: true,
});

let i = new Image('https://example.com/image.png');
collect({image: i});

navigate(input.url);

let {created} = job;

let $$ = load_html('<p id="p1">p1</p><p id="p2">p2</p>');
collect({data: $$('#p2').text()});

load_more(<selector>);
load_more('.search-results');
load_more('.search-results', {children: '.result-item', trigger_selector: '.btn-load-more', timeout: 10000});

let {pages} = load_sitemap({url: 'https://example.com/sitemap.xml.gz'});
let {children} = load_sitemap({url: 'https://example.com/sitemap-index.xml'});

navigate('https://example.com');
location.href; // "https://example.com/"

let p = new Money(10, 'USD');
collect({product_price: p});

mouse_to(0, 0);

navigate(input.url);
navigate('https://example.com');

// 等待浏览器触发 DOM 内容加载事件
navigate(`url`, {wait_until: 'domcontentloaded'}); 

// 为导航添加 referer
navigate(`url`, {referer: `url`}); 

// 等待毫秒数，默认 30000 ms
navigate(`url`, {timeout: 45000}); 

// 如果 URL 返回 404 状态码，则不抛出错误
navigate(`url`, {allow_status: [404]});

// 指定浏览器宽高
navigate(`url`, {
    fingerprint: {screen: {width: 400, height: 400}},
});

next_stage({url: 'http://example.com', page: 1});

let page_data = parse();
collect({
    title: page_data.title,
    price: page_data.price,
});

preserve_proxy_session();

press_key('Enter');
press_key('Backspace');

proxy_location({country: 'us'});

// 纬度范围: [-85, 85], 经度范围: [-180, 180]
proxy_location({lat: 37.7749, long: 122.4194}); 

// 半径单位为 km
proxy_location({lat: 37.7749, long: 122.4194, country: 'US', radius: 100}); 

navigate('http://google.com');
let redirects = redirect_history();
// 返回:
// [
//   'http://google.com',
//   'http://www.google.com',
//   'https://www.google.com/',
// ]

rerun_stage({url: 'http://example.com/other-page'});

let {href} = parse().anchor_elem_data;
collect({final_url: resolve_url(href)});

let headers = response_headers();
console.log('content-type', headers['content-type']);

let res = request('http://www.example.com');
let res = request({url: 'http://www.example.com', method: 'POST', headers: {'Content-type': 'application/json'}, body: {hello: 'world'}})

right_click('#item');

run_stage(2, {url: 'http://example.com', page: 1});

scroll_to('.author-profile');
scroll_to('top'); // 滚动到页面顶部
scroll_to('bottom'); // 滚动到页面底部
scroll_to('top', {immediate: true}); // 立即跳转到顶部

scroll_to_all('.author-profiles');

select('#country', 'Canada');

set_lines(products_so_far);
set_lines(products_so_far, i=>{
    if (!i.price)
        throw new Error('缺少价格');
});

set_session_cookie(`domain`, `name`, `value`);

set_session_headers({'HEADER_NAME': 'HEADER_VALUE'});

solve_captcha();
solve_captcha({type: 'simple', selector: '#image', input: '#input'});

collect({status_code: status_code()});

tag_all_responses(<field>, <pattern>, <options>);
tag_all_responses('resp', /url/, {jsonp: true});
tag_all_responses('resp', /url/, {allow_error: true});
tag_all_responses('profiles', /\/api\/profile/);
navigate('https://example.com/sports');
let profiles = parse().profiles;
for (let profile of profiles)
    collect(profile);

let SEC = 1000;
let download = tag_download(/example.com\/foo\/bar/);
click('button#download');
let file1 = download.next_file({timeout: 10*SEC});
let file2 = download.next_file({timeout: 20*SEC});
collect({file1, file2});

tag_image(field, selector);
tag_image('image', '#product-image');

tag_response('resp', /url/, {jsonp: true});
tag_response('resp', /url/, {allow_error: true});
tag_response('resp', (req, res)=>{
            if (req.url.includes('/api/'))
            {
                let request_body = req.body;
                let request_headers = req.headers;
                let response_body = res.body;
                let response_headers = res.headers;
            }
        });

tag_response('teams', /\/api\/teams/);
navigate('https://example.com/sports');
let teams = parse().teams;
for (let team of teams)
    collect(team);

tag_screenshot('html_screenshot', {filename: 'screen'});
tag_screenshot('view', {full_page: false}); // full_page 默认为 true

tag_script('teams', '#preload-data');
tag_script('ssr_state', '#__SSR_DATA__');
navigate('https://example.com/');
collect(parse().ssr_state);

tag_serp('serp_bing_results', 'bing');
tag_serp('serp_google_results', 'google');

tag_video(field, selector);
tag_video('video', '#product-video', {download: true});

tag_window_field(field, key);
tag_window_field('initData', '__INIT_DATA__');

track_event_listeners();

type(<selector>, <text>);
type('#location', 'New York');

// 如果输入框非空，则替换文本
type(<selector>, <text>, {replace: true}); 

// 输入到 id 以 "input-box" 结尾的元素
type('[id$=input-box]', <text>); 

// 发送 'Enter' 键
type(<selector>, ['Enter']); 

// 输入文本后发送 'Enter'
type(<selector>, ['Some text', 'Enter']); 

// 删除 1 个字符
type(<selector>, ['Backspace']); 

let u = new URL('https://example.com');

verify_requests(({url, error, type, response})=>{
    if (response.status != 404 && type == 'Font')
        throw new Error('字体加载失败');
});

let v = new Video('https://example.com/video.mp4');
collect({video: v});

wait(<selector>);
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^="/product"]');

// 等待毫秒数，默认 30000 ms
wait(<selector>, {timeout: 5000}); 

// 等待元素隐藏
wait(<selector>, {hidden: true}); 

// 等待 iframe 内的元素
wait(<selector>, {inside: '#iframe_id'}); 

wait_any(['#title', '#notfound']);

wait_for_parser_value(<field>[, <validate_fn>][, opt]);
wait_for_parser_value('profile');
wait_for_parser_value('listings.0.price', v=>{
    return parseInt(v) > 0;
}, {timeout: 5000});

wait_for_text(<selector>, <text>);
wait_for_text('.location', 'New York');

wait_hidden(<selector>);
wait_hidden('#welcome-splash');
wait_hidden(<selector>, {timeout: 5000});

wait_network_idle();
wait_network_idle({
    timeout: 1000,
    ignore: [/long_request/, 'https://example.com'],
});

wait_page_idle();
wait_page_idle({
    ignore: [<selector1>, <selector2>],
    idle_timeout: 1000,
});

wait_visible(<selector>);
wait_visible('#welcome-splash');
wait_visible(<selector>, {timeout: 5000});

$(<selector>);
wait($('.store-card'));

$('.selector').filter_includes('text').click();

emulate_device('iPhone X');
emulate_device('Pixel 2');

let url = input.url;

$('#example').text();
$('$example').attr('href');
$('#example').text_sane(); /* 类似 $().text()，但会修剪文本并将所有空白字符替换为单个空格 "a b \t\n\n c" -> "a b c" */

let current_url = location.href; 

let i = new Image('https://example.com/image.png');
collect({image: i});

let v = new Video('https://example.com/video.mp4');
collect({video: v});

let p = new Money(10, 'USD');
collect({product_price: p});