Skip to content

Commit 57c0b4e

Browse files
Copilotwadepicketttdykstra
authored
Document Safari's lack of *.localhost domain support (#36374)
* Initial plan * Add Safari compatibility note to localhost-tld.md Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> * Apply suggestions from code review - clarified "client" app. * Update aspnetcore/test/localhost-tld.md Co-authored-by: Tom Dykstra <tdykstra@microsoft.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com> Co-authored-by: Wade Pickett <wpickett@microsoft.com> Co-authored-by: Tom Dykstra <tdykstra@microsoft.com>
1 parent 8fc8049 commit 57c0b4e

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

aspnetcore/test/localhost-tld.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how using localhost as top-level domain can make testing easi
44
monikerRange: '>= aspnetcore-10.0'
55
ms.author: tdykstra
66
ms.custom:
7-
ms.date: 08/26/2025
7+
ms.date: 11/19/2025
88
title: Support for the .localhost top-level domain
99
uid: test/localhost-tld
1010
---
@@ -23,7 +23,9 @@ ASP.NET Core's built-in HTTP server, Kestrel, correctly treats any `*.localhost`
2323

2424
## Browser compatibility
2525

26-
While web browsers automatically resolve `*.localhost` names to the local loopback address, other apps might treat `*.localhost` names as regular domain names and attempt to resolve them via their corresponding DNS stack. If your DNS configuration doesn't resolve `*.localhost` names to an address, they fail to connect. You can continue to use the regular `localhost` name to address your apps when not in a web browser.
26+
While most modern evergreen browsers automatically resolve `*.localhost` names to the local loopback address, Safari on macOS doesn't support this feature. In Safari, you should use the regular `localhost` name instead of `*.localhost` domain names.
27+
28+
Some client apps other than Safari and evergreen web browsers treat `*.localhost` names as regular domain names and attempt to resolve them via their corresponding DNS stack. If your DNS configuration doesn't resolve `*.localhost` names to an address, they fail to connect. You can continue to use the regular `localhost` name to address your apps when not in a web browser.
2729

2830
## HTTPS development certificate
2931

0 commit comments

Comments
 (0)