getHTML

取得指定 DOM 元素的原始碼（透過選擇器）。預設情況下，它會自動穿透元素包含的所有陰影根。

用法

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

參數

名稱	類型	詳細資訊
options	GetHTMLOptions	命令選項
options.includeSelectorTag 可選	布林值	如果為 true，則包含選擇器元素標籤（預設值：true）
options.pierceShadowRoot 可選	布林值	如果為 true，則包含 DOM 中所有 Web 元件的陰影根內容
options.removeCommentNodes 可選	布林值	如果為 true，則從 HTML 中移除所有註解節點，例如 <!--?lit$206212805$--><!--?lit$206212805$-->
options.prettify 可選	布林值	如果為 true，則會美化 HTML 輸出

範例

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://ionic.dev.org.tw/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>
    `)
});