From 066048f34e5d1d13591612d27ed7e63c486efc38 Mon Sep 17 00:00:00 2001 From: Danny Tuppeny Date: Tue, 8 Aug 2023 10:38:31 +0100 Subject: [PATCH] Add an explicit note about drive letter colons See https://github.com/microsoft/vscode-languageserver-node/issues/1280 --- _includes/types/uri.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/_includes/types/uri.md b/_includes/types/uri.md index 1ffd89829..86b5b067a 100644 --- a/_includes/types/uri.md +++ b/_includes/types/uri.md @@ -16,6 +16,13 @@ We also maintain a node module to parse a string into `scheme`, `authority`, `pa Many of the interfaces contain fields that correspond to the URI of a document. For clarity, the type of such a field is declared as a `DocumentUri`. Over the wire, it will still be transferred as a string, but this guarantees that the contents of that string can be parsed as a valid URI. +Care should be taken to handle encoded in URIs. Some clients (such as VS Code) may encode colons in drive letters while others do not. The following URIs should be considered equivalent and are both valid for clients and servers to use: + +``` +file:///c:/project/readme.md +file:///c%3A/project/readme.md +``` +
```typescript