大网数据广告活动
Web 标准与前端开发

Segments.prototype.containing()

· 52CE 我爱测

`Segments` 实例的 **`containing()`** 方法返回一个描述字符串中包含指定索引处的码元片段的对象。

Segments 实例的 containing() 方法返回一个描述字符串中包含指定索引处的码元片段的对象。

JavaScript 演示:Segments.prototype.containing()

const segmenterFr = new Intl.Segmenter("fr", { granularity: "word" });
const string = "Que ma joie demeure";

const segments = segmenterFr.segment(string);

console.log(segments.containing(5));
// 期望输出:
// Object {segment: 'ma', index: 4, input: 'Que ma joie demeure', isWordLike: true}

语法

containing(codeUnitIndex)

参数

  • codeUnitIndex
    • : 指定原始输入字符串中代码单元索引的数字。如果省略该值,默认为 0。

返回值

一个(具有以下属性的)描述原始字符串片段的对象,如果提供的索引值超出范围则返回 undefined。

  • segment
    • : 包含从原始输入字符串中提取的片段的字符串。
  • index
    • : 原始输入字符串中片段开始处的代码单元索引。
  • input
    • : 被分割的完整输入字符串。
  • isWordLike
    • : 仅当 granularity 为 "word" 时为布尔值;否则为 undefined。如果 granularity 为 "word",则当片段是类似词语的(即由字母、数字、表意文字等组成)时,isWordLike 为 true;否则为 false。

示例

// ┃0 1 2 3 4 5┃6┃7┃8┃9  ← 代码单元索引
// ┃A l l o n s┃-┃y┃!┃   ← 代码单元
const input = "Allons-y!";

const segmenter = new Intl.Segmenter("fr", { granularity: "word" });
const segments = segmenter.segment(input);

let current = segments.containing();
// { index: 0, segment: "Allons", isWordLike: true }

current = segments.containing(4);
// { index: 0, segment: "Allons", isWordLike: true }

current = segments.containing(6);
// { index: 6, segment: "-", isWordLike: false }

current = segments.containing(current.index + current.segment.length);
// { index: 7, segment: "y", isWordLike: true }

current = segments.containing(current.index + current.segment.length);
// { index: 8, segment: "!", isWordLike: false }

current = segments.containing(current.index + current.segment.length);
// undefined

规范

浏览器兼容性

参见

  • Intl.Segmenter
  • Intl/Segmenter/segment

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。