mirror of https://github.com/dreamhunter2333/cloudflare_temp_email.git synced 2026-07-14 00:43:43 +08:00

Files

Dream Hunter e38015a5b6 refactor: E2E tests use real email() handler (#870 )

* refactor: add receive_mail E2E endpoint using real email() handler

Add /admin/test/receive_mail that constructs a mock ForwardableEmailMessage
and calls the real email() handler, so E2E tests exercise the full mail
processing pipeline. Extract both test endpoints into e2e_test_api.ts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: trigger CI

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-06 10:15:02 +08:00

fixtures

refactor: E2E tests use real email() handler (#870 )

2026-03-06 10:15:02 +08:00

scripts

…

tests

test: add E2E tests for auto-reply settings (#868 )

2026-03-06 00:22:25 +08:00

docker-compose.yml

…

Dockerfile.e2e

…

Dockerfile.frontend

…

Dockerfile.worker

…

package-lock.json

…

package.json

…

playwright.config.ts

…

README.md

…

README.md

E2E Tests

End-to-end tests for Cloudflare Temp Email using Playwright and Mailpit, fully containerized with Docker Compose.

Prerequisites

Docker and Docker Compose

Quick Start

cd e2e

# Build, start all services, run tests, and exit
npm test

# Clean up containers and volumes
npm run test:down

npm test runs docker compose up --build, which:

Starts Mailpit (SMTP on :1025, HTTP API on :8025)
Builds and starts the Worker (wrangler dev on :8787)
Builds and starts the Frontend (vite dev on :5173)
Builds and runs the E2E runner (Playwright), which waits for services, initializes the DB, and runs all tests

The exit code reflects the test result.

Test Structure

Project	Directory	What it tests
`api`	`tests/api/`	Worker API endpoints — health check, address CRUD, send mail via SMTP
`browser`	`tests/browser/`	Frontend UI — login, inbox view, reply with HTML, XSS sanitization

Services

Service	Container	Port	Purpose
Mailpit SMTP	`mailpit`	1025	Captures outgoing emails
Mailpit HTTP	`mailpit`	8025	API to verify captured emails
Worker	`worker`	8787	Backend API with E2E config
Frontend	`frontend`	5173	Vue frontend dev server

Test Results

Test results and HTML reports are exported via volumes:

e2e/test-results/ — test artifacts
e2e/playwright-report/ — HTML report

Configuration

The E2E worker uses fixtures/wrangler.toml.e2e with:

E2E_TEST_MODE = true — enables test seed endpoint
DISABLE_ADMIN_PASSWORD_CHECK = true — allows unauthenticated admin calls
DEFAULT_SEND_BALANCE = 10 — allows sending without admin approval
SMTP pointed at Mailpit container (mailpit:1025)