On 8/29/24 3:57 PM, 'Frank Tang (譚永鋒)' via blink-dev wrote:



On Wed, Aug 28, 2024 at 1:23 PM Chris Harrelson <chris...@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?



    On Thu, Aug 22, 2024 at 4:11 PM Chromestatus
    <ad...@cr-status.appspotmail.com> wrote:


                Contact emails

        ft...@google.com


                Explainer

        None


                Specification

        https://tc39.es/proposal-intl-locale-info


                Design 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>Internationalization
        
<https://bugs.chromium.org/p/chromium/issues/list?q=component:Blink%3EJavaScript%3EInternationalization>



                TAG review

        None


                TAG review status

        Not applicable


                Risks



                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)?

        Yes


                Is this feature fully tested by web-platform-tests
                
<https://chromium.googlesource.com/chromium/src/+/main/docs/testing/web_platform_tests.md>?

        Yes

        
https://github.com/tc39/test262/tree/main/test/intl402/Locale/prototype/get*



                Flag name on chrome://flags

        None


                Finch feature name

        None


                Non-finch justification

        None


                Requires code in //chrome?

        False


                Tracking bug

        https://issues.chromium.org/issues/42203769


                Sample 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).

        None


                Link to entry on the Chrome Platform Status

        https://chromestatus.com/feature/5122839207477248?gate=5125593355255808



                Links to previous Intent discussions

        Ready for Trial:
        
https://groups.google.com/a/chromium.org/g/blink-dev/c/fIZhzp4AWbk/m/bocUBCXbBwAJ



        This intent message was generated by Chrome Platform Status
        <https://chromestatus.com>.
-- 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+unsubscr...@chromium.org.
        To view this discussion on the web visit
        
https://groups.google.com/a/chromium.org/d/msgid/blink-dev/000000000000f3725c06204dc61d%40google.com
        
<https://groups.google.com/a/chromium.org/d/msgid/blink-dev/000000000000f3725c06204dc61d%40google.com?utm_medium=email&utm_source=footer>.



--
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+unsubscr...@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 <https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CA%2B7fzPE2o94N%2B0B6ZvpP-kn5YtKE8Bb-qPiH5-ur3Ap_ZDyNvw%40mail.gmail.com?utm_medium=email&utm_source=footer>.

--
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+unsubscr...@chromium.org.
To view this discussion on the web visit 
https://groups.google.com/a/chromium.org/d/msgid/blink-dev/81bfa88b-ae8c-4806-9f9c-e263947648b5%40chromium.org.

Reply via email to