Intent to Ship: relaunch Intl Locale Info feature in newly added functions
Chromestatus
Contact emails
ft...@google.comExplainer
NoneSpecification
https://tc39.es/proposal-intl-locale-infoDesign docs
https://docs.google.com/document/d/1BSpa-LKE69LL1g5CHZ3G06XEfffauwS24atfSUQiIDY/edit?usp=sharing
Summary
Intl Locale Info API is a new Stage ECMAScript TC39 proposal to enhance the Intl.Locale object by exposing Locale information, such as week data (first day in a week, weekend start day, weekend end day, minimun day in the first week), and text direction hour cycle used in the locale. https://github.com/tc39/proposal-intl-locale-info We launch Intl Locale Info API w/ getters but later the proposal changed to rename these getters to functions. We need to deprecate the getter and relaunch the functions . The deprecation of getters is tracked in https://chromestatus.com/feature/5148228059398144
Blink component
Blink>JavaScript>InternationalizationTAG review
NoneTAG review status
Not applicableRisks
Interoperability and Compatibility
None
Gecko: Positive (https://bugzilla.mozilla.org/show_bug.cgi?id=1693576)
WebKit: Shipped/Shipping (https://developer.apple.com/documentation/safari-release-notes/safari-17-release-notes) Shipped in Safari version 17
Web developers: Positive (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getCalendars) https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getCalendars https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getCollations https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getHourCycles https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getNumberingSystems https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTextInfo https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTimeZones https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getWeekInfo
Other signals:
Ergonomics
minor change, similar to all other functions in Intl.Locale object already.
Activation
non- minor change, similar to all other functions in Intl.Locale object already.
Security
none - minor change, similar to all other functions in Intl.Locale object already.
WebView application risks
Does this intent deprecate or change behavior of existing APIs, such that it has potentially high risk for Android WebView-based applications?
None
Debuggability
minor change, similar to all other functions in Intl.Locale object already.
Will this feature be supported on all six Blink platforms (Windows, Mac, Linux, ChromeOS, Android, and Android WebView)?
YesIs this feature fully tested by web-platform-tests?
Yeshttps://github.com/tc39/test262/tree/main/test/intl402/Locale/prototype/get*
Flag name on chrome://flags
NoneFinch feature name
NoneNon-finch justification
NoneRequires code in //chrome?
FalseTracking bug
https://issues.chromium.org/issues/42203769Sample links
https://github.com/tc39/proposal-intl-locale-info?tab=readme-ov-file#high-level-design
Estimated milestones
| Shipping on desktop | 130 |
| DevTrial on desktop | 129 |
| Shipping on Android | 130 |
| DevTrial on Android | 129 |
Anticipated spec changes
Open questions about a feature may be a source of future web compat or interop issues. Please list open issues (e.g. links to known github issues in the project for the feature specification) whose resolution may introduce web compat/interop risk (e.g., changing to naming or structure of the API in a non-backward-compatible way).
NoneLink to entry on the Chrome Platform Status
https://chromestatus.com/feature/5122839207477248?gate=5125593355255808Links to previous Intent discussions
Ready for Trial: https://groups.google.com/a/chromium.org/g/blink-dev/c/fIZhzp4AWbk/m/bocUBCXbBwAJ
Chris Harrelson
--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/000000000000f3725c06204dc61d%40google.com.
Frank Tang (譚永鋒)
Does this feature change the behavior of existing web-exposed APIs for Locale? If so, what is the compat risk of breaking existing sites?
Add Intl.Locale.prototype.getCalendars ( )
Add Intl.Locale.prototype.getCollations ( )
Add Intl.Locale.prototype.getHourCycles ( )
Add Intl.Locale.prototype.getNumberingSystems ( )
Add Intl.Locale.prototype.getTimeZones ( )
Add Intl.Locale.prototype.getTextInfo ( )
Add Intl.Locale.prototype.getWeekInfo ( )
譚永鋒 /
🌭
🍊 Sr. Software Engineer
ftang via Chromestatus
Mike Taylor
On 8/29/24 3:57 PM, 'Frank Tang (譚永鋒)' via blink-dev wrote:
On Wed, Aug 28, 2024 at 1:23 PM Chris Harrelson <chri...@chromium.org> wrote:
Does this feature change the behavior of existing web-exposed APIs for Locale? If so, what is the compat risk of breaking existing sites?
With this launch, the pre-existing Intl.Locale object will add 7 additional functions
Add Intl.Locale.prototype.getCalendars ( )
Add Intl.Locale.prototype.getCollations ( )
Add Intl.Locale.prototype.getHourCycles ( )
Add Intl.Locale.prototype.getNumberingSystems ( )
Add Intl.Locale.prototype.getTimeZones ( )
Add Intl.Locale.prototype.getTextInfo ( )
Add Intl.Locale.prototype.getWeekInfo ( )
These functions are already available in Safari 17 (Released September 18, 2023 — Version 17 (19616.1.27))"Updated Intl.Locale to replace info getters with individual get… methods. (105570888)" (see https://developer.apple.com/documentation/safari-release-notes/safari-17-release-notes?language=_6)
so it should have minimum compat risk of breaking existing sites
To clarify: this intent adds the new getter methods, but we're
not deprecating or removing the existing getter properties that
shipped in M99, correct? I see that the type for `firstDay` is
different when returned by `getWeekInfo()` - are there any other
notable changes?
Do you have a plan to deprecate the getter properties?
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CA%2B7fzPE2o94N%2B0B6ZvpP-kn5YtKE8Bb-qPiH5-ur3Ap_ZDyNvw%40mail.gmail.com.
Frank Tang (譚永鋒)
2. This particular launch is NOT removing the existing getter properties that shipped in M99.
Chris Harrelson
Mike Taylor
Thanks Frank. LGTM2
Domenic Denicola
Thanks Frank. LGTM2
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/000000000000f3725c06204dc61d%40google.com.
--
Frank Yung-Fong Tang
譚永鋒 /
Sr. Software Engineer
--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CA%2B7fzPE2o94N%2B0B6ZvpP-kn5YtKE8Bb-qPiH5-ur3Ap_ZDyNvw%40mail.gmail.com.