Skip to content

Conversation

@samuel871211
Copy link
Contributor

Description

  • Of the request methods defined by this specification, the GET, HEAD, OPTIONS, and TRACE methods are defined to be safe.
  • Of the request methods defined by this specification, PUT, DELETE, and safe request methods are idempotent.

Motivation

Additional details

RFC9110 Safe Methods
RFC9110 Idempotent Methods

Related issues and pull requests

@samuel871211 samuel871211 requested review from a team as code owners November 19, 2025 07:38
@samuel871211 samuel871211 requested review from bsmth and removed request for a team November 19, 2025 07:38
@github-actions github-actions bot added Content:HTTP HTTP docs Content:Glossary Glossary entries size/s [PR only] 6-50 LoC changed labels Nov 19, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 19, 2025

Preview URLs

Flaws (3)

URL: /en-US/docs/Web/HTTP/Guides/Connection_management_in_HTTP_1.x
Title: Connection management in HTTP/1.x
Flaw count: 3

  • unknown:
    • No generic content config found
    • no blog root
    • no blog root

(comment last updated: 2025-11-19 11:07:20)

Copy link
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a lot for the suggestion. I think the important part on the glossary is that we're talking about common methods, and TRACE is lesser-used because people like to disable it for concerns that it leaks information about the server:

For this reason, I think it's probably better to omit it on the glossary page

…index.md

Co-authored-by: Brian Smith <brian@smith.berlin>
@samuel871211 samuel871211 requested a review from bsmth November 19, 2025 10:58
@github-actions github-actions bot added size/xs [PR only] 0-5 LoC changed and removed size/s [PR only] 6-50 LoC changed labels Nov 19, 2025
Removed TRACE method from the list of common safe methods.
@github-actions github-actions bot removed the Content:Glossary Glossary entries label Nov 19, 2025
Copy link
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@bsmth bsmth merged commit bc45e7d into mdn:main Nov 19, 2025
8 checks passed
@samuel871211 samuel871211 deleted the updateSafeMethodsAndIdempotentMethods branch November 19, 2025 11:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:HTTP HTTP docs size/xs [PR only] 0-5 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants