w3c / w3c/webdriver

Add an HTTP header with the status code

Open
#1,045 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
718
Forks
228
PR merge metrics
No merged PRs in 30d

Description

Currently, the only way for an intermediary node to determine whether it needs to clean state (eg. if an upstream session has disappeared unexpectedly) is by decoding the response. Providing more information could prevent this. Notably, encoding the status of the response as an HTTP header in responses would be useful.

I'd suggest X-WebDriver and the value being the value of the error field of an errored response. A value of success would also be added, to allow intermediary nodes to differentiate between Level 1 and Level 2 compliant upstream ends.

Contributor guide

Open the contributing guide

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.

Research direction

Review the response and error-field definitions in the WebDriver specification, along with the Level 1 and Level 2 compliance behavior mentioned in the issue. Define how the X-WebDriver header carries error values or success, and document the resulting response behavior for intermediary nodes.

Written by the indexing model from the issue text.

Assessment

Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.