docsify/test/e2e/vue.test.js

const stripIndent = require('common-tags/lib/stripIndent');
const docsifyInit = require('../helpers/docsify-init');
const { test, expect } = require('./fixtures/docsify-init-fixture');

const vueURLs = [
  '/node_modules/vue2/dist/vue.js',
  '/node_modules/vue3/dist/vue.global.js',
];

test.describe('Vue.js Compatibility', () => {
  function getSharedConfig() {
    const config = {
      config: {
        vueComponents: {
          'button-counter': {
            template: `
              <button @click="counter++">{{ counter }}</button>
            `,
            data: function () {
              return {
                counter: 0,
              };
            },
          },
        },
        vueGlobalOptions: {
          data: function () {
            return {
              counter: 0,
              msg: 'vueglobaloptions',
            };
          },
        },
        vueMounts: {
          '#vuemounts': {
            data: function () {
              return {
                counter: 0,
                msg: 'vuemounts',
              };
            },
          },
        },
      },
      markdown: {
        homepage: stripIndent`
          <div id="vuefor"><span v-for="i in 5">{{ i }}</span></div>

          <button-counter id="vuecomponent">---</button-counter>

          <div id="vueglobaloptions">
            <p v-text="msg">---</p>
            <button @click="counter += 1">+</button>
            <span>{{ counter }}<span>
          </div>

          <div id="vuemounts">
            <p v-text="msg">---</p>
            <button @click="counter += 1">+</button>
            <span>{{ counter }}<span>
          </div>

          <div id="vuescript">
            <p v-text="msg">---</p>
            <button @click="counter += 1">+</button>
            <span>{{ counter }}<span>
          </div>

          <script>
            const vueConfig = {
              data() {
                return {
                  counter: 0,
                  msg: 'vuescript'
                }
              },
            }
            const vueMountElm = '#vuescript';
            const vueVersion = Number(window.Vue.version.charAt(0));

            if (vueVersion === 2) {
              new Vue(vueConfig).$mount(vueMountElm);
            }
            else if (vueVersion === 3) {
              Vue.createApp(vueConfig).mount(vueMountElm);
            }
          </script>
        `,
      },
    };

    return config;
  }

  // Tests
  // ---------------------------------------------------------------------------
  for (const vueURL of vueURLs) {
    const vueVersion = Number(vueURL.match(/vue(\d+)/)[1]); // 2|3

    test.describe(`Vue v${vueVersion}`, () => {
      for (const executeScript of [true, undefined]) {
        test(`renders content when executeScript is ${executeScript}`, async ({
          page,
        }) => {
          const docsifyInitConfig = getSharedConfig();

          docsifyInitConfig.config.executeScript = executeScript;
          docsifyInitConfig.scriptURLs = vueURL;

          await docsifyInit(docsifyInitConfig);

          // Static
          await expect(page.locator('#vuefor')).toHaveText('12345');
          await expect(page.locator('#vuecomponent')).toHaveText('0');
          await expect(page.locator('#vueglobaloptions p')).toHaveText(
            'vueglobaloptions'
          );
          await expect(page.locator('#vueglobaloptions > span')).toHaveText(
            '0'
          );
          await expect(page.locator('#vuemounts p')).toHaveText('vuemounts');
          await expect(page.locator('#vuemounts > span')).toHaveText('0');
          await expect(page.locator('#vuescript p')).toHaveText('vuescript');
          await expect(page.locator('#vuescript > span')).toHaveText('0');

          // Reactive
          await page.click('#vuecomponent');
          await expect(page.locator('#vuecomponent')).toHaveText('1');
          await page.click('#vueglobaloptions button');
          await expect(page.locator('#vueglobaloptions > span')).toHaveText(
            '1'
          );
          await page.click('#vuemounts button');
          await expect(page.locator('#vuemounts > span')).toHaveText('1');
          await page.click('#vuescript button');
          await expect(page.locator('#vuescript > span')).toHaveText('1');
        });
      }

      test(`ignores content when Vue is not present`, async ({ page }) => {
        const docsifyInitConfig = getSharedConfig();

        await docsifyInit(docsifyInitConfig);
        await page.evaluate(() => 'Vue' in window === false);
        await expect(page.locator('#vuefor')).toHaveText('{{ i }}');
        await expect(page.locator('#vuecomponent')).toHaveText('---');
        await expect(page.locator('#vueglobaloptions p')).toHaveText('---');
        await expect(page.locator('#vuemounts p')).toHaveText('---');
        await expect(page.locator('#vuescript p')).toHaveText('---');
      });

      test(`ignores content when vueComponents, vueMounts, and vueGlobalOptions are undefined`, async ({
        page,
      }) => {
        const docsifyInitConfig = getSharedConfig();

        docsifyInitConfig.config.vueComponents = undefined;
        docsifyInitConfig.config.vueGlobalOptions = undefined;
        docsifyInitConfig.config.vueMounts = undefined;
        docsifyInitConfig.scriptURLs = vueURL;

        await docsifyInit(docsifyInitConfig);
        await expect(page.locator('#vuefor')).toHaveText('{{ i }}');
        await expect(page.locator('#vuecomponent')).toHaveText('---');
        await expect(page.locator('#vueglobaloptions p')).toHaveText('---');
        await expect(page.locator('#vuemounts p')).toHaveText('---');
        await expect(page.locator('#vuescript p')).toHaveText('vuescript');
      });

      test(`ignores content when vueGlobalOptions is undefined`, async ({
        page,
      }) => {
        const docsifyInitConfig = getSharedConfig();

        docsifyInitConfig.config.vueGlobalOptions = undefined;
        docsifyInitConfig.scriptURLs = vueURL;

        await docsifyInit(docsifyInitConfig);
        await expect(page.locator('#vuefor')).toHaveText('12345');
        await expect(page.locator('#vuecomponent')).toHaveText('0');
        await expect(page.locator('#vuecomponent')).toHaveText('0');
        expect(await page.locator('#vueglobaloptions p').innerText()).toBe('');
        await expect(page.locator('#vuemounts p')).toHaveText('vuemounts');
        await expect(page.locator('#vuescript p')).toHaveText('vuescript');
      });

      test(`ignores content when vueMounts is undefined`, async ({ page }) => {
        const docsifyInitConfig = getSharedConfig();

        docsifyInitConfig.config.vueMounts['#vuemounts'] = undefined;
        docsifyInitConfig.scriptURLs = vueURL;

        await docsifyInit(docsifyInitConfig);
        await expect(page.locator('#vuefor')).toHaveText('12345');
        await expect(page.locator('#vuecomponent')).toHaveText('0');
        await expect(page.locator('#vueglobaloptions p')).toHaveText(
          'vueglobaloptions'
        );
        await expect(page.locator('#vuemounts p')).toHaveText(
          'vueglobaloptions'
        );
        await expect(page.locator('#vuescript p')).toHaveText('vuescript');
      });

      test(`ignores <script> when executeScript is false`, async ({ page }) => {
        const docsifyInitConfig = getSharedConfig();

        docsifyInitConfig.config.executeScript = false;
        docsifyInitConfig.scriptURLs = vueURL;

        await docsifyInit(docsifyInitConfig);
        await expect(page.locator('#vuescript p')).toHaveText(
          'vueglobaloptions'
        );
      });
    });
  }
});