Intl.ListFormat

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021년 4월.

Intl.ListFormat 객체는 언어별 목록 서식을 가능하게 합니다.

시도해 보기

const vehicles = ["Motorcycle", "Bus", "Car"];

const formatter = new Intl.ListFormat("en", {
  style: "long",
  type: "conjunction",
});
console.log(formatter.format(vehicles));
// Expected output: "Motorcycle, Bus, and Car"

const formatter2 = new Intl.ListFormat("de", {
  style: "short",
  type: "disjunction",
});
console.log(formatter2.format(vehicles));
// Expected output: "Motorcycle, Bus oder Car"

const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });
console.log(formatter3.format(vehicles));
// Expected output: "Motorcycle Bus Car"

생성자

Intl.ListFormat()

Intl.ListFormat 객체를 생성합니다.

정적 메서드

Intl.ListFormat.supportedLocalesOf()

런타임의 기본 로케일로 돌아가지 않고 지원되는 제공된 로케일이 포함된 배열을 반환합니다.

인스턴스 속성

다음 속성은 Intl.ListFormat.prototype에 정의되어 있으며, 모든 Intl.ListFormat 인스턴스에 공유됩니다.

Intl.ListFormat.prototype.constructor

인스턴스 객체를 생성한 생성자 함수입니다. Intl.ListFormat 인스턴스의 경우, 초기 값은 Intl.ListFormat 생성자입니다.

Intl.ListFormat.prototype[@@toStringTag]

@@toStringTag 속성의 초기 값은 문자열 "Intl.ListFormat" 입니다. 이 속성은 Object.prototype.toString()에서 사용합니다.

인스턴스 메서드

Intl.ListFormat.prototype.format()

목록의 요소를 표현하는 언어별 형식의 문자열을 반환합니다.

Intl.ListFormat.prototype.formatToParts()

로케일 인식 방식으로 값 목록의 형식을 맞추는 데 사용할 수 있는 컴포넌트를 의미하는 객체 배열을 반환합니다.

Intl.ListFormat.prototype.resolvedOptions()

현재 Intl.ListFormat 객체를 구성하는 동안 계산된 로케일 및 스타일 서식 지정 옵션을 반영하는 속성을 가진 새 객체를 반환합니다.

예제

format 사용하기

다음 예제는 영어를 사용하여 목록 형식기를 만드는 방법을 보여줍니다.

js
const list = ["Motorcycle", "Bus", "Car"];

console.log(
  new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus and Car

console.log(
  new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus or Car

console.log(
  new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),
);
// Motorcycle Bus Car

formatToParts 사용하기

다음 예제는 형식이 맞춰진 부분을 반환하는 목록 형식기를 만드는 방법을 보여줍니다.

js
const list = ["Motorcycle", "Bus", "Car"];
console.log(
  new Intl.ListFormat("en-GB", {
    style: "long",
    type: "conjunction",
  }).formatToParts(list),
);

// [ { "type": "element", "value": "Motorcycle" },
//   { "type": "literal", "value": ", " },
//   { "type": "element", "value": "Bus" },
//   { "type": "literal", "value": ", and " },
//   { "type": "element", "value": "Car" } ];

명세서

Specification

ECMAScript® 2027 Internationalization API Specification
# listformat-objects

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025년 2월 11일 by MDN contributors.

View this page on GitHub • Report a problem with this content

표준 내장 객체
Intl.ListFormat
생성자
1. Intl.ListFormat()
정적 메서드
1. supportedLocalesOf()
인스턴스 메서드
1. Intl.ListFormat.prototype.format()
2. Intl.ListFormat.prototype.formatToParts()
3. resolvedOptions()
상속
Object/Function
정적 메서드
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call()
4. Function.prototype.toSource()
5. Function.prototype[@@hasInstance]()
정적 속성
1. Function: displayName
2. Function.prototype.length
3. Function: name
4. Function
5. Function.arguments
6. Function.prototype.caller
인스턴스 메서드
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
인스턴스 속성
1. Object.prototype.__proto__
2. Object.prototype.constructor
관련 페이지
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter

Intl.ListFormat

In this article

Help improve MDN