دریافت HTML

دریافت کد منبع المان DOM مشخص شده توسط انتخابگر. به صورت پیش‌فرض، به طور خودکار از همه shadow root‌های المان‌های موجود در المان عبور می‌کند.

استفاده

$(selector).getHTML({ includeSelectorTag, pierceShadowRoot, removeCommentNodes, prettify })

پارامترها

نام	نوع	جزئیات
options	GetHTMLOptions	گزینه‌های دستور
options.includeSelectorTag اختیاری	Boolean	اگر درست باشد، تگ المان انتخابگر را هم شامل می‌شود (پیش‌فرض: true)
options.pierceShadowRoot اختیاری	Boolean	اگر درست باشد، محتوای shadow root‌های تمام کامپوننت‌های وب در DOM را شامل می‌شود (پیش‌فرض: true)
options.removeCommentNodes اختیاری	Boolean	اگر درست باشد، تمام گره‌های توضیح را از HTML حذف می‌کند، مثلاً <!--?lit$206212805$--><!--?lit$206212805$--> (پیش‌فرض: true)
options.prettify اختیاری	Boolean	اگر درست باشد، خروجی HTML به صورت خوانا و منظم خواهد بود (پیش‌فرض: true)

مثال‌ها

index.html

<div id="test">
    <span>Lorem ipsum dolor amet</span>
</div>

getHTML.js

it('should get html for certain elements', async () => {
    var outerHTML = await $('#test').getHTML();
    console.log(outerHTML);
    // outputs:
    // "<div id="test"><span>Lorem ipsum dolor amet</span></div>"

    var innerHTML = await $('#test').getHTML({ includeSelectorTag: false });
    console.log(innerHTML);
    // outputs:
    // "<span>Lorem ipsum dolor amet</span>"
});

getHTMLShadow.js

it('allows to snapshot shadow dom', async () => {
    await browser.url('https://ionicframework.com/docs/usage/v8/button/basic/demo.html?ionic:mode=md')

    // get snapshot of web component without its styles
    const snapshot = await $('ion-button').getHTML({ excludeElements: ['style'] })

    // assert snapshot
    await expect(snapshot).toMatchInlineSnapshot(`
        <ion-button class="md button button-solid ion-activatable ion-focusable hydrated">Default
            <template shadowrootmode="open">
                <button type="button" class="button-native" part="native">
                <span class="button-inner">
                    <slot name="icon-only"></slot>
                    <slot name="start"></slot>
                    <slot></slot>
                    <slot name="end"></slot>
                </span>
                <ion-ripple-effect role="presentation" class="md hydrated">
                    <template shadowrootmode="open"></template>
                </ion-ripple-effect>
                </button>
            </template>
        </ion-button>
    `)
});

مقادیر بازگشتی

• <String> return: HTML المان مشخص شده