URLSearchParam.append Encoding Behavior

[sublimemm]

Documenting URLSearchParam.append Encoding Behavior and adding an example.

Description

Motivation

Additional details

Related issues and pull requests

Fix #34896

[github-actions]

Preview URLs (6 pages)

• /en-US/docs/Web/API/URL/searchParams
• /en-US/docs/Web/API/URL/search
• /en-US/docs/Web/API/URLSearchParams/URLSearchParams
• /en-US/docs/Web/API/URLSearchParams/append
• /en-US/docs/Web/API/URLSearchParams/toString
• /en-US/docs/Web/API/URLSearchParams

External URLs (2)

URL: /en-US/docs/Web/API/URLSearchParams
Title: URLSearchParams

• https://url.spec.whatwg.org/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/URLSearchParams/toString
Title: URLSearchParams: toString() method

• https://url.spec.whatwg.org/ (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-02-02 20:50:51)

[Josh-Cena]

@sublimemm For interfaces like URLSearchParams, instead of putting behavior documentation under a specific method, we put it under the class's page, because the methods closely interact with each other (there are multiple ways to modify and retrieve data and it's actually abstractly about how the interface transforms external input, not the specific inner workings of append() itself). You will want to add it to https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams instead.

[Josh-Cena]

I've moved the explanation to the landing page and added some examples so it also addresses #34896. Thanks for sending it in!