Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

🐛 Bug Report: a non-string header value crashes the whole browser service

Open
#22 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
15/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
bun, playwright, typescript
Domain
api, backend

Research direction

Start with the header schemas and the page.route handlers in src/routes/screenshots.ts and the corresponding reports route. Check how non-string header values are validated and how route callback errors are handled; the report says the failure occurs at screenshots.ts:64. Done means malformed headers return a 400 response, the service stays up, and a regression test covers both endpoints and non-string values.

Written by the indexing model from the issue text.

Description

👟 Reproduction steps
  1. Start the service (docker compose up, or bun run src/server.ts).
  2. Send a header whose value is not a string:
    curl -X POST localhost:3000/v1/screenshots -H 'content-type: application/json' \
      -d '{"url":"https://example.com","headers":{"X-Retry":1}}'
    
  3. The request gets no response, and GET /v1/health now fails: the server process has exited.

Same for POST /v1/reports, and for true, null, arrays or objects as the value.

👍 Expected behavior

A 400 validation error, like any other malformed field; the service keeps running.

👎 Actual Behavior

The schemas accept any JSON value for headers (z.record(z.string(), z.any())), but Playwright's
route.continue() only takes string values. It throws inside the page.route handler, nothing catches
the rejection, and Bun exits:

error: continue: headers[6].value: expected string, got number
      at .../src/routes/screenshots.ts:64:24

Every other capture in flight fails with it.

🎲 Appwrite version

Different version (specify in environment)

💻 Operating system

MacOS

🧱 Your Environment

appwrite/docker-browser main @ 3856d53, run locally with Bun 1.3.2 (the Dockerfile's version) and Google Chrome on macOS arm64.

👀 Have you spent some time to check if this issue has been raised before?
  • I checked and didn't find similar issue
🏢 Have you read the Code of Conduct?

I have a fix with a regression test ready. Could this be assigned to me so I can open a PR?

Dominant language
TypeScript
Stars
8
Forks
2
Avg merge
3d 8h
Merged PRs (30d)
4

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from appwrite/docker-browser

All issues in appwrite/docker-browser

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.