Location: port property incorrectly documented

[rotu]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Location/port

What specific section or headline is this issue about?

Example and description

What information was incorrect, unhelpful, or incomplete?

Example and description are incorrect according to Firefox, Chrome, and Safari.

Description:

The port property of the Location interface is a string containing the port number of the URL. If the URL does not contain an explicit port number, it will be set to ''.

Example:

// Let's an <a id="myAnchor" href="https://developer.mozilla.org:443/en-US/docs/Location.port"> element be in the document
const anchor = document.getElementByID("myAnchor");
const result = anchor.port; // Returns:'443'

let a = document.createElement("a");
a.href = 'https://developer.mozilla.org:443/en-US/docs/Location.port';
console.log(a.port) // prints ""

What did you expect to see?

Port seems to be null if the url has the default port for the protocol, not just if it's unset.

If the example was correct, it should probably have an indication of WHEN it changed.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

MDN metadata

Page report details

• Folder: en-us/web/api/location/port
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/Location/port
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/location/port/index.md
• Last commit: 1238ffa
• Document last modified: 2023-11-26T22:27:03.000Z

[Josh-Cena]

We should add the same info as https://developer.mozilla.org/en-US/docs/Web/API/URL/port.

[rotu]

Even that could use rewording.

The port property of the URL interface is a string containing the port number of the URL.

Maybe instead something like "The port property is a string which is either "" or the port number of the URL."

A URL object normalizes it to "" if the same as the per-protocol default. But I'm not sure if that means the Location object must do the same.

[skyclouds2001]

https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement/port, https://developer.mozilla.org/en-US/docs/Web/API/HTMLAreaElement/port, https://developer.mozilla.org/en-US/docs/Web/API/WorkerLocation/port also need update, too

[skyclouds2001]

And another issue is that the example is explaining HTMLAnchorElement.port, not Location.port