initial setup of tests

Author: dwightjack

.github/workflows/main.yml

@@ -17,7 +17,6 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
       - uses: pnpm/action-setup@v4
@@ -28,3 +27,24 @@ jobs:
       - run: pnpm i
       - run: pnpm run lint
       - run: pnpm run build
+  test:
+    timeout-minutes: 60
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4
+        with:
+          node-version-file: '.node-version'
+          cache: 'pnpm'
+      - run: pnpm i
+      - name: Install Playwright Browsers
+        run: pnpm exec playwright install chromium --with-deps
+      - name: Run Playwright tests
+        run: pnpm run test
+      - uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 10

.gitignore

@@ -3,4 +3,10 @@ node_modules
 dist
 dist-ssr
 *.local
-!.vscode
+!.vscode
+
+# Playwright
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/

package.json

@@ -5,10 +5,12 @@
   "description": "A configurable pomodoro-like timer",
   "type": "module",
   "scripts": {
-    "dev": "vite",
+    "dev": "vite --port 8888",
     "build": "vue-tsc --noEmit && vite build",
     "lint": "eslint 'src/**/*.*'",
-    "serve": "vite preview"
+    "serve": "vite preview",
+    "dev:test": "vite dev --port 8888 --mode=test",
+    "test": ""
   },
   "packageManager": "[email protected]",
   "engines": {
@@ -24,6 +26,7 @@
   },
   "devDependencies": {
     "@eslint/js": "9.20.0",
+    "@playwright/test": "^1.51.0",
     "@tailwindcss/vite": "4.0.9",
     "@types/node": "22.13.7",
     "@vitejs/plugin-vue": "5.2.1",

playwright.config.ts

@@ -0,0 +1,53 @@
+import { defineConfig, devices } from '@playwright/test';
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// import dotenv from 'dotenv';
+// import path from 'path';
+// dotenv.config({ path: path.resolve(__dirname, '.env') });
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export default defineConfig({
+  testDir: './tests',
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  forbidOnly: !!process.env.CI,
+  /* Retry on CI only */
+  retries: process.env.CI ? 2 : 0,
+  /* Opt out of parallel tests on CI. */
+  workers: process.env.CI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: 'html',
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Base URL to use in actions like `await page.goto('/')`. */
+    baseURL: 'http://localhost:8888',
+
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+    {
+      name: 'Mobile Chrome',
+      use: { ...devices['Pixel 5'] },
+    },
+  ],
+
+  webServer: {
+    command: 'pnpm run dev:test',
+    url: 'http://localhost:8888',
+    reuseExistingServer: !process.env.CI,
+  },
+});

pnpm-lock.yaml

@@ -25,7 +25,7 @@ const label = computed(() => {
   if (mins === 0) {
     return `${toSpacedString(type)}: less than 1 minute left`;
   }
-  return `${toSpacedString(type)}: ${mins + 1} minutes left`;
+  return `${toSpacedString(type)}: ${mins + (secs === 0 ? 0 : 1)} minutes left`;
 });
 
 const classes = computed(() => getIntervalTypeColor(type as IntervalType));

src/components/BaseTimer.vue

@@ -1,13 +1,18 @@
 <script setup lang="ts">
 import IntervalSquare from '@/components/IntervalSquare.vue';
 import { useCycle } from '@/stores/cycle';
+import { useId } from 'vue';
 
 const cycle = useCycle();
+const id = useId();
 </script>
 <template>
   <div>
-    <h2 class="sr-only">Intervals</h2>
-    <ul class="flex flex-wrap items-center justify-center gap-1">
+    <h2 :id="id + '-cycle'" aria-hidden="true">Intervals</h2>
+    <ul
+      class="flex flex-wrap items-center justify-center gap-1"
+      :aria-labelledby="id + '-cycle'"
+    >
       <IntervalSquare
         v-for="(interval, i) in cycle.intervals"
         :key="interval.id"

src/components/TheCycle.vue

@@ -4,14 +4,19 @@ import { Interval, IntervalType } from '@/types';
 import { useStorage } from '@vueuse/core';
 import { uniqId } from '@/utils';
 
+const initialIntervals = () => [
+  {
+    type: IntervalType.Work,
+    duration: 45 * 60 * 1000,
+    id: uniqId([]),
+  },
+];
+
 export const useCycle = defineStore('cycle', () => {
-  const intervals = useStorage<Interval[]>('intervals', [
-    {
-      type: IntervalType.Work,
-      duration: 45 * 60 * 1000,
-      id: uniqId([]),
-    },
-  ]);
+  const intervals =
+    import.meta.env.MODE !== 'test'
+      ? useStorage<Interval[]>('intervals', initialIntervals())
+      : ref<Interval[]>(initialIntervals());
 
   const countdowns = ref<number[]>([]);
   const current = ref(0);

src/stores/cycle.ts

@@ -0,0 +1,29 @@
+import { test, expect } from '@playwright/test';
+
+test.describe('initial state', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto('/');
+  });
+  test('default timer', async ({ page }) => {
+    await expect(page.getByRole('timer')).toContainText('45:00');
+  });
+  test('default timer - accessible name', async ({ page }) => {
+    await expect(page.getByRole('timer')).toContainText('45 minutes left');
+  });
+  test('cycle list', async ({ page }) => {
+    const list = page.getByRole('list', { name: 'Intervals' });
+    await expect(list.getByRole('listitem')).toHaveCount(1);
+    await expect(list.getByRole('listitem')).toContainText('W');
+    await expect(list.getByRole('listitem')).toContainText('45:00');
+  });
+
+  test('controls', async ({ page }) => {
+    const controls = page.getByRole('group', { name: 'Timer controls' });
+    await expect(controls.getByRole('button', { name: 'Play' })).toBeVisible();
+    await expect(controls.getByRole('button', { name: 'Skip' })).toBeVisible();
+    await expect(controls.getByRole('button', { name: 'Reset' })).toBeVisible();
+    await expect(
+      controls.getByRole('button', { name: 'Settings' }),
+    ).toBeVisible();
+  });
+});