类: Uri

资源标识符

属性

authority

readonly authority: string

Authority 是 http://www.example.com/some/path?query#fragment 中的 www.example.com 部分。第一个双斜杠和下一个斜杠之间的部分。

定义在

packages/extension-api/src/extension-api.d.ts:1832

---

fragment

readonly fragment: string

Fragment 是 http://www.example.com/some/path?query#fragment 中的 fragment 部分。

定义在

packages/extension-api/src/extension-api.d.ts:1852

---

fsPath

readonly fsPath: string

表示此 Uri 的相应文件系统路径的字符串。

定义在

packages/extension-api/src/extension-api.d.ts:1842

---

path

readonly path: string

Path 是 http://www.example.com/some/path?query#fragment 中的 /some/path 部分。

定义在

packages/extension-api/src/extension-api.d.ts:1837

---

query

readonly query: string

Query 是 http://www.example.com/some/path?query#fragment 中的 query 部分。

定义在

packages/extension-api/src/extension-api.d.ts:1847

---

scheme

readonly scheme: string

Scheme 是 http://www.example.com/some/path?query#fragment 中的 http 部分。第一个冒号之前的部分。

定义在

packages/extension-api/src/extension-api.d.ts:1826

方法

toString()

toString(): string

返回值

string

定义在

packages/extension-api/src/extension-api.d.ts:1891

---

with()

with(change): Uri

从此 Uri 派生一个新的 Uri。

const foo = Uri.parse('http://foo');
const httpsFoo = foo.with({ scheme: 'https' });
// httpsFoo is now 'https://foo'

参数

• change

描述对此 Uri 的更改的对象。要取消设置组件，请使用 undefined 或空字符串。

• change.authority?: string

新的 authority，默认为此 Uri 的 authority。

• change.fragment?: string

新的 fragment，默认为此 Uri 的 fragment。

• change.path?: string

新的 path，默认为此 Uri 的 path。

• change.query?: string

新的 query，默认为此 Uri 的 query。

• change.scheme?: string

新的 scheme，默认为此 Uri 的 scheme。

返回值

Uri

一个新的 Uri，反映了给定的更改。如果更改没有更改任何内容，则将返回 this Uri。

定义在

packages/extension-api/src/extension-api.d.ts:1868

---

file()

static file(path): Uri

从文件系统路径创建 URI。scheme 将为 file。

参数

• path: string

返回值

Uri

定义在

packages/extension-api/src/extension-api.d.ts:1805

---

joinPath()

static joinPath(base, ...pathSegments): Uri

创建一个新的 uri，其路径是将基本 uri 的路径与提供的路径段连接的结果。

参数

• base: Uri

一个 uri。必须有路径。

• ...pathSegments: string[]

一个或多个路径片段

返回值

Uri

一个新的 uri，其路径与给定的片段连接

定义在

packages/extension-api/src/extension-api.d.ts:1815

---

parse()

static parse(value, strict?): Uri

从字符串创建 URI，例如 http://www.example.com/some/path、file:///usr/home 或 scheme:with/path。

注意，一段时间以来，没有 scheme 的 uri 被接受。这不是正确的，因为所有 uri 都应该有 scheme。为了避免现有代码的破坏，添加了可选的 strict 参数。我们强烈建议使用它，例如 Uri.parse('my:uri', true)

参数

• value: string

Uri 的字符串值。

• strict?: boolean

当 value 为空或无法解析 scheme 时抛出错误。

返回值

Uri

一个新的 Uri 实例。

参见

Uri.toString

定义在

packages/extension-api/src/extension-api.d.ts:1799