Segments.prototype.containing()
Baseline
2024
Newly available
Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Phương thức containing() của các instance Segments trả về một đối tượng mô tả phân đoạn trong chuỗi chứa code unit tại chỉ số được chỉ định.
Try it
const segmenterFr = new Intl.Segmenter("fr", { granularity: "word" });
const string = "Que ma joie demeure";
const segments = segmenterFr.segment(string);
console.log(segments.containing(5));
// Expected output:
// Object {segment: 'ma', index: 4, input: 'Que ma joie demeure', isWordLike: true}
Cú pháp
containing(codeUnitIndex)
Tham số
codeUnitIndexOptional-
Số chỉ định chỉ số của code unit trong chuỗi đầu vào gốc. Nếu giá trị bị bỏ qua, mặc định là
0.
Giá trị trả về
Một đối tượng mô tả phân đoạn của chuỗi gốc với các thuộc tính sau, hoặc undefined nếu giá trị chỉ số được cung cấp nằm ngoài phạm vi.
segment-
Chuỗi chứa phân đoạn được trích xuất từ chuỗi đầu vào gốc.
index-
Chỉ số code unit trong chuỗi đầu vào gốc tại đó phân đoạn bắt đầu.
input-
Chuỗi đầu vào hoàn chỉnh đã được phân đoạn.
isWordLike-
Giá trị boolean chỉ khi
granularitylà"word"; nếu không, làundefined. Nếugranularitylà"word", thìisWordLikelàtruekhi phân đoạn giống từ (tức là gồm các chữ cái/số/chữ tượng hình/v.v.); nếu không, làfalse.
Ví dụ
// ┃0 1 2 3 4 5┃6┃7┃8┃9 ← chỉ số code unit
// ┃A l l o n s┃-┃y┃!┃ ← code unit
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
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-%segmentsprototype%.containing |