ferridriver-bdd 0.4.0

BDD/Cucumber test framework for ferridriver. 144 built-in Gherkin steps backed by the Page API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//! Emulation step definitions: viewport, timezone, locale, color scheme.
//!
//! Each step builds a partial [`ferridriver::options::BrowserContextOptions`]
//! bag with just the field it cares about, then calls
//! [`ferridriver::Page::apply_context_options`] — the single entry
//! point for every context-level state mutation.

use crate::step::StepError;
use crate::world::BrowserWorld;
use ferridriver_bdd_macros::{given, step};

async fn apply(
  world: &mut BrowserWorld,
  label: &str,
  opts: ferridriver::options::BrowserContextOptions,
) -> Result<(), StepError> {
  world
    .page()
    .apply_context_options(&opts)
    .await
    .map_err(|e| StepError::wrap(label, e))
}

#[given("I set timezone to {string}")]
async fn set_timezone(world: &mut BrowserWorld, timezone: String) {
  apply(
    world,
    "set timezone",
    ferridriver::options::BrowserContextOptions {
      timezone_id: Some(timezone),
      ..Default::default()
    },
  )
  .await?;
}

#[given("I set locale to {string}")]
async fn set_locale(world: &mut BrowserWorld, locale: String) {
  apply(
    world,
    "set locale",
    ferridriver::options::BrowserContextOptions {
      locale: Some(locale),
      ..Default::default()
    },
  )
  .await?;
}

#[given("I emulate color scheme {string}")]
async fn emulate_color_scheme(world: &mut BrowserWorld, scheme: String) {
  let opts = ferridriver::options::EmulateMediaOptions {
    color_scheme: ferridriver::options::MediaOverride::Set(scheme),
    ..Default::default()
  };
  world
    .page()
    .emulate_media(&opts)
    .await
    .map_err(|e| StepError::wrap("emulate color scheme", e))?;
}

#[step("I set user agent to {string}")]
async fn set_user_agent(world: &mut BrowserWorld, ua: String) {
  apply(
    world,
    "set user agent",
    ferridriver::options::BrowserContextOptions {
      user_agent: Some(ua),
      ..Default::default()
    },
  )
  .await?;
}

#[step("I set viewport to {int}x{int}")]
async fn set_viewport(world: &mut BrowserWorld, width: i64, height: i64) {
  world
    .page()
    .set_viewport_size(width, height)
    .await
    .map_err(|e| StepError::wrap("set viewport", e))?;
}

#[step("I set geolocation to {float},{float}")]
async fn set_geolocation(world: &mut BrowserWorld, lat: f64, lng: f64) {
  apply(
    world,
    "set geolocation",
    ferridriver::options::BrowserContextOptions {
      geolocation: Some(ferridriver::options::Geolocation {
        latitude: lat,
        longitude: lng,
        accuracy: 1.0,
      }),
      ..Default::default()
    },
  )
  .await?;
}