viewpoint-test 0.4.3

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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
#![cfg(feature = "integration")]

//! Integration tests for TestHarness.

use std::sync::Once;
use std::time::Duration;
use viewpoint_core::DocumentLoadState;
use viewpoint_test::{TestConfig, TestHarness, expect, expect_page};

static TRACING_INIT: Once = Once::new();

fn init_tracing() {
    TRACING_INIT.call_once(|| {
        tracing_subscriber::fmt()
            .with_env_filter(
                tracing_subscriber::EnvFilter::from_default_env()
                    .add_directive(tracing::Level::INFO.into()),
            )
            .with_test_writer()
            .try_init()
            .ok();
    });
}

// ============================================================================
// Harness Creation Tests
// ============================================================================

#[tokio::test]
async fn test_harness_new_creates_page() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");

    // Verify we have access to fixtures
    let page = harness.page();
    assert!(!page.is_closed());

    // Verify browser and context are accessible
    assert!(harness.browser().is_some());
    assert!(harness.context().is_some());
}

#[tokio::test]
async fn test_harness_builder_configuration() {
    init_tracing();

    let harness = TestHarness::builder()
        .headless(true)
        .timeout(Duration::from_secs(60))
        .build()
        .await
        .expect("should create harness");

    assert_eq!(harness.config().timeout, Duration::from_secs(60));
    assert!(harness.config().headless);
}

#[tokio::test]
async fn test_harness_new_page() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");

    // Create additional page
    let page2 = harness.new_page().await.expect("should create new page");

    // Both pages should be valid
    assert!(!harness.page().is_closed());
    assert!(!page2.is_closed());
}

#[tokio::test]
async fn test_harness_explicit_close() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");

    // Explicit close should work
    harness.close().await.expect("should close harness");
}

#[tokio::test]
async fn test_config_defaults() {
    let config = TestConfig::default();

    assert!(config.headless);
    assert_eq!(config.timeout, Duration::from_secs(30));
}

#[tokio::test]
async fn test_config_builder() {
    let config = TestConfig::builder()
        .headless(false)
        .timeout(Duration::from_secs(120))
        .build();

    assert!(!config.headless);
    assert_eq!(config.timeout, Duration::from_secs(120));
}

#[tokio::test]
async fn test_harness_from_browser() {
    init_tracing();

    // Create a browser directly
    let browser = viewpoint_test::Browser::launch()
        .headless(true)
        .launch()
        .await
        .expect("should launch browser");

    // Create harness from existing browser
    let harness = TestHarness::from_browser(&browser)
        .await
        .expect("should create harness from browser");

    // Should have page and context, but browser() returns None (not owned)
    assert!(!harness.page().is_closed());
    assert!(harness.context().is_some());
    assert!(harness.browser().is_none()); // We don't own the browser

    // Clean up
    drop(harness);
    browser.close().await.expect("should close browser");
}

#[tokio::test]
async fn test_harness_from_context() {
    init_tracing();

    // Create browser and context directly
    let browser = viewpoint_test::Browser::launch()
        .headless(true)
        .launch()
        .await
        .expect("should launch browser");

    let context = browser.new_context().await.expect("should create context");

    // Create harness from existing context
    let harness = TestHarness::from_context(&context)
        .await
        .expect("should create harness from context");

    // Should have page, but context() and browser() return None (not owned)
    assert!(!harness.page().is_closed());
    assert!(harness.context().is_none()); // We don't own the context
    assert!(harness.browser().is_none()); // We don't own the browser

    // Clean up
    drop(harness);
    // context and browser will be cleaned up when dropped
}

// ============================================================================
// Assertion Tests
// ============================================================================

#[tokio::test]
async fn test_expect_to_be_visible() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    let heading = page.locator("h1");
    expect(&heading)
        .to_be_visible()
        .await
        .expect("heading should be visible");
}

#[tokio::test]
async fn test_expect_to_be_hidden() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    // Non-existent element should be hidden
    let nonexistent = page.locator("#does-not-exist-xyz123");
    expect(&nonexistent)
        .to_be_hidden()
        .await
        .expect("nonexistent element should be hidden");
}

#[tokio::test]
async fn test_expect_to_have_text() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    let heading = page.locator("h1");
    expect(&heading)
        .to_have_text("Example Domain")
        .await
        .expect("heading should have expected text");
}

#[tokio::test]
async fn test_expect_to_contain_text() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    let heading = page.locator("h1");
    expect(&heading)
        .to_contain_text("Example")
        .await
        .expect("heading should contain text");
}

#[tokio::test]
async fn test_expect_text_assertion_failure() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    let heading = page.locator("h1");
    let result = expect(&heading)
        .timeout(Duration::from_millis(100))
        .to_have_text("Not The Right Text")
        .await;

    assert!(result.is_err(), "should fail with wrong text");
    let err = result.unwrap_err();
    assert!(err.message.contains("text"), "error should mention text");
}

#[tokio::test]
async fn test_expect_page_to_have_url() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com/")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    expect_page(page)
        .to_have_url("https://example.com/")
        .await
        .expect("page should have expected URL");
}

#[tokio::test]
async fn test_expect_page_to_have_url_containing() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com/")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    expect_page(page)
        .to_have_url_containing("example.com")
        .await
        .expect("page URL should contain 'example.com'");
}

#[tokio::test]
async fn test_expect_page_to_have_title() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    expect_page(page)
        .to_have_title("Example Domain")
        .await
        .expect("page should have expected title");
}

#[tokio::test]
async fn test_expect_not_negation() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    let heading = page.locator("h1");

    // not().to_have_text() should pass when text doesn't match
    expect(&heading)
        .not()
        .to_have_text("Wrong Text")
        .await
        .expect("not assertion should pass");
}

#[tokio::test]
async fn test_expect_to_be_checked() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    page.goto("https://httpbin.org/forms/post")
        .wait_until(DocumentLoadState::Load)
        .goto()
        .await
        .expect("should navigate");

    // Find an unchecked checkbox
    let checkbox = page.locator("input[type='checkbox'][value='cheese']");

    // Check it
    checkbox.check().await.expect("should check");

    // Verify it's checked
    expect(&checkbox)
        .to_be_checked()
        .await
        .expect("checkbox should be checked");

    // Uncheck it
    checkbox.uncheck().await.expect("should uncheck");

    // Verify it's not checked
    expect(&checkbox)
        .not()
        .to_be_checked()
        .await
        .expect("checkbox should not be checked");
}

// ============================================================================
// Harness Cleanup Tests
// ============================================================================

#[tokio::test]
async fn test_harness_close_explicit() {
    init_tracing();

    let harness = TestHarness::new().await.expect("should create harness");
    let page = harness.page();

    // Do some work
    page.goto("https://example.com")
        .wait_until(DocumentLoadState::DomContentLoaded)
        .goto()
        .await
        .expect("should navigate");

    // Explicitly close
    harness.close().await.expect("should close harness");
}

#[tokio::test]
async fn test_harness_cleanup_on_drop() {
    init_tracing();

    {
        let harness = TestHarness::new().await.expect("should create harness");
        let page = harness.page();

        page.goto("https://example.com")
            .wait_until(DocumentLoadState::DomContentLoaded)
            .goto()
            .await
            .expect("should navigate");

        // harness will be dropped here
    }

    // If we get here, drop didn't crash
}