viewpoint-test 0.2.16

Test framework for Viewpoint browser automation with Playwright-style assertions
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

//! Assertion API for browser automation tests.
//!
//! The `expect` function creates assertion builders for locators and pages,
//! enabling fluent async assertions.
//!
//! # Example
//!
//! ```
//! # #[cfg(feature = "integration")]
//! # tokio_test::block_on(async {
//! # use viewpoint_core::Browser;
//! use viewpoint_test::{expect, expect_page};
//! # let browser = Browser::launch().headless(true).launch().await.unwrap();
//! # let context = browser.new_context().await.unwrap();
//! # let page = context.new_page().await.unwrap();
//! # page.goto("https://example.com").goto().await.unwrap();
//!
//! // Assert element is visible
//! let locator = page.locator("h1");
//! expect(&locator).to_be_visible().await.unwrap();
//!
//! // Assert text content
//! expect(&locator).to_have_text("Example Domain").await.unwrap();
//!
//! // Assert page URL
//! expect_page(&page).to_have_url("https://example.com/").await.unwrap();
//! # });
//! ```

mod count;
mod locator;
mod locator_helpers;
mod page;
mod soft;
mod soft_locator;
mod soft_page;
mod state;
mod text;

#[cfg(test)]
mod tests;

pub use locator::LocatorAssertions;
pub use page::PageAssertions;
pub use soft::{SoftAssertionError, SoftAssertions};
pub use soft_locator::SoftLocatorAssertions;
pub use soft_page::SoftPageAssertions;

use viewpoint_core::{Locator, Page};

/// Create assertions for a locator.
///
/// # Example
///
/// ```
/// # #[cfg(feature = "integration")]
/// # tokio_test::block_on(async {
/// # use viewpoint_core::Browser;
/// use viewpoint_test::expect;
/// # let browser = Browser::launch().headless(true).launch().await.unwrap();
/// # let context = browser.new_context().await.unwrap();
/// # let page = context.new_page().await.unwrap();
/// # page.goto("https://example.com").goto().await.unwrap();
///
/// let locator = page.locator("h1");
/// expect(&locator).to_be_visible().await.unwrap();
/// expect(&locator).to_have_text("Example Domain").await.unwrap();
/// # });
/// ```
pub fn expect<'a>(locator: &'a Locator<'a>) -> LocatorAssertions<'a> {
    LocatorAssertions::new(locator)
}

/// Create assertions for a page.
///
/// # Example
///
/// ```
/// # #[cfg(feature = "integration")]
/// # tokio_test::block_on(async {
/// # use viewpoint_core::Browser;
/// use viewpoint_test::expect_page;
/// # let browser = Browser::launch().headless(true).launch().await.unwrap();
/// # let context = browser.new_context().await.unwrap();
/// # let page = context.new_page().await.unwrap();
/// # page.goto("https://example.com").goto().await.unwrap();
///
/// expect_page(&page).to_have_url("https://example.com/").await.unwrap();
/// expect_page(&page).to_have_title("Example Domain").await.unwrap();
/// # });
/// ```
pub fn expect_page(page: &Page) -> PageAssertions<'_> {
    PageAssertions::new(page)
}

/// Trait for creating assertions from different types.
///
/// This enables a unified `expect()` function that works with both
/// locators and pages.
pub trait Expectable<'a> {
    /// The assertion builder type for this value.
    type Assertions;

    /// Create an assertion builder for this value.
    fn assertions(&'a self) -> Self::Assertions;
}

impl<'a> Expectable<'a> for Locator<'a> {
    type Assertions = LocatorAssertions<'a>;

    fn assertions(&'a self) -> Self::Assertions {
        LocatorAssertions::new(self)
    }
}

impl<'a> Expectable<'a> for Page {
    type Assertions = PageAssertions<'a>;

    fn assertions(&'a self) -> Self::Assertions {
        PageAssertions::new(self)
    }
}