How to use ElementHandleContentFrameTests class of Microsoft.Playwright.Tests package

1/*
2 * MIT License
3 *
4 * Copyright (c) Microsoft Corporation.
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in all
14 * copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 */
24
25using System.Linq;
26using System.Threading.Tasks;
27using Microsoft.Playwright.NUnit;
28using NUnit.Framework;
29
30namespace Microsoft.Playwright.Tests
31{
32    public class ElementHandleContentFrameTests : PageTestEx
33    {
34        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should work")]
35        public async Task ShouldWork()
36        {
37            await Page.GotoAsync(Server.EmptyPage);
38            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
39            var elementHandle = await Page.QuerySelectorAsync("#frame1");
40            var frame = await elementHandle.ContentFrameAsync();
41            Assert.AreEqual(Page.Frames.ElementAt(1), frame);
42        }
43
44        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should work for cross-process iframes")]
45        public async Task ShouldWorkForCrossProcessIframes()
46        {
47            await Page.GotoAsync(Server.EmptyPage);
48            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.CrossProcessPrefix + "/empty.html");
49            var elementHandle = await Page.QuerySelectorAsync("#frame1");
50            var frame = await elementHandle.ContentFrameAsync();
51            Assert.AreEqual(Page.Frames.ElementAt(1), frame);
52        }
53
54        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should work for cross-frame evaluations")]
55        public async Task ShouldWorkForCrossFrameEvaluations()
56        {
57            await Page.GotoAsync(Server.EmptyPage);
58            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
59            var frame = Page.Frames.ElementAt(1);
60            var elementHandle = (IElementHandle)await frame.EvaluateHandleAsync("() => window.top.document.querySelector('#frame1')");
61            Assert.AreEqual(frame, await elementHandle.ContentFrameAsync());
62        }
63
64        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should return null for non-iframes")]
65        public async Task ShouldReturnNullForNonIframes()
66        {
67            await Page.GotoAsync(Server.EmptyPage);
68            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
69            var frame = Page.Frames.ElementAt(1);
70            var elementHandle = (IElementHandle)await frame.EvaluateHandleAsync("() => document.body");
71            Assert.Null(await elementHandle.ContentFrameAsync());
72        }
73
74        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should return null for document.documentElement")]
75        public async Task ShouldReturnNullForDocumentDocumentElement()
76        {
77            await Page.GotoAsync(Server.EmptyPage);
78            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
79            var frame = Page.Frames.ElementAt(1);
80            var elementHandle = (IElementHandle)await frame.EvaluateHandleAsync("() => document.documentElement");
81            Assert.Null(await elementHandle.ContentFrameAsync());
82        }
83    }
84}
85

Source: ElementHandleContentFrameTests.cs

/*
 * MIT License
 *
 * Copyright (c) Microsoft Corporation.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

using System.Linq;
using System.Threading.Tasks;
using Microsoft.Playwright.NUnit;
using NUnit.Framework;

namespace Microsoft.Playwright.Tests
{
    public class ElementHandleContentFrameTests : PageTestEx
    {
        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should work")]
        public async Task ShouldWork()
        {
            await Page.GotoAsync(Server.EmptyPage);
            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
            var elementHandle = await Page.QuerySelectorAsync("#frame1");
            var frame = await elementHandle.ContentFrameAsync();
            Assert.AreEqual(Page.Frames.ElementAt(1), frame);
        }

        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should work for cross-process iframes")]
        public async Task ShouldWorkForCrossProcessIframes()
        {
            await Page.GotoAsync(Server.EmptyPage);
            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.CrossProcessPrefix + "/empty.html");
            var elementHandle = await Page.QuerySelectorAsync("#frame1");
            var frame = await elementHandle.ContentFrameAsync();
            Assert.AreEqual(Page.Frames.ElementAt(1), frame);
        }

        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should work for cross-frame evaluations")]
        public async Task ShouldWorkForCrossFrameEvaluations()
        {
            await Page.GotoAsync(Server.EmptyPage);
            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
            var frame = Page.Frames.ElementAt(1);
            var elementHandle = (IElementHandle)await frame.EvaluateHandleAsync("() => window.top.document.querySelector('#frame1')");
            Assert.AreEqual(frame, await elementHandle.ContentFrameAsync());
        }

        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should return null for non-iframes")]
        public async Task ShouldReturnNullForNonIframes()
        {
            await Page.GotoAsync(Server.EmptyPage);
            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
            var frame = Page.Frames.ElementAt(1);
            var elementHandle = (IElementHandle)await frame.EvaluateHandleAsync("() => document.body");
            Assert.Null(await elementHandle.ContentFrameAsync());
        }

        [PlaywrightTest("elementhandle-content-frame.spec.ts", "should return null for document.documentElement")]
        public async Task ShouldReturnNullForDocumentDocumentElement()
        {
            await Page.GotoAsync(Server.EmptyPage);
            await FrameUtils.AttachFrameAsync(Page, "frame1", Server.EmptyPage);
            var frame = Page.Frames.ElementAt(1);
            var elementHandle = (IElementHandle)await frame.EvaluateHandleAsync("() => document.documentElement");
            Assert.Null(await elementHandle.ContentFrameAsync());
        }
    }
}