tinymce.util.URI

此类用于处理 URI/URL 字符串的解析、修改和序列化。

概述

构造函数

方法

构造函数

URI

public constructor function URI(url: String, settings: Object)

构造一个新的 URI 实例。

参数

• url (String) - 要解析的 URI 字符串。

• settings (Object) - 可选的设置对象。

方法

getURI()

getURI(noProtoHost: Boolean)

返回内部结构的完整 URI。

参数

• noProtoHost (Boolean) - 可选，无主机和协议部分。默认为 false。

isDomSafe()

isDomSafe(uri: String, context: Object, options: Object): Boolean

检查 URI 在文档对象模型 (DOM) 中使用是否安全。如果该 URI 可以在 DOM 中使用且不会引发潜在安全问题，则返回true。

参数

• uri (String) - 要验证的 URI。

• context (Object) - 可选，正在使用该元素的 HTML 标签名。

• options (Object) - 可选，用于确定 URI 是否安全的一组选项。

返回值

• Boolean - 如果 URI 安全则返回 True，否则返回 false。

isSameOrigin()

isSameOrigin(uri: tinymce.util.URI): Boolean

判断给定的 URI 是否与此 URI 同源。基于 RFC-6454 标准。支持 DEFAULT_PORTS 中列出的协议的默认端口。不支持的协议将安全失败：如果端口规范不同，它们将不匹配。

参数

• uri (URI) - 要比较的 URI 实例。

返回值

• Boolean - 如果源相同则返回 True。

setPath()

setPath(path: String)

设置 URI 的内部路径部分。

参数

• path (String) - 要设置的路径字符串。

toAbsPath()

toAbsPath(base: String, path: String)

将相对路径转换为绝对路径。

参数

• base (String) - 转换路径的基准点。

• path (String) - 要转换为绝对路径的相对路径。

toAbsolute()

toAbsolute(uri: String, noHost: Boolean): String

基于当前 URI 实例位置将指定的 URI 转换为绝对 URI。

示例

// 将相对 URL 转换为绝对 URL url 将为 http://www.site.com/dir/somedir/somefile.htm
const url = new tinymce.util.URI('http://www.site.com/dir/').toAbsolute('somedir/somefile.htm');

参数

• uri (String) - 要转换为相对路径/URI 的 URI。

• noHost (Boolean) - 无主机和协议前缀。

返回值

• String - 从当前 URI 实例指定点开始的绝对 URI。

toRelPath()

toRelPath(base: String, path: String)

将绝对路径转换为相对路径。

参数

• base (String) - 转换路径的基准点。

• path (String) - 要转换为相对路径的绝对路径。

toRelative()

toRelative(uri: String): String

基于当前 URI 实例位置将指定的 URI 转换为相对 URI。

示例

// Converts an absolute URL to an relative URL url will be somedir/somefile.htm
const url = new tinymce.util.URI('http://www.site.com/dir/').toRelative('http://www.site.com/dir/somedir/somefile.htm');

参数

• uri (String) - 要转换为相对路径/URI 的 URI。

返回值

• String - 从当前 URI 实例指定点开始的相对 URI。