You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[RFC] Consider deprecating FulfilledPromise and RejectedPromise (mark as internal only) #155
What purpose does the FulfilledPromise and RejectedPromise have? It's my understanding these should be used internally only and using the resolve() and reject() functions is the preferred alternative (or in many cases simply omit it).
For instance, here's some example code that highlights how using these classes is often unneeded:
Do we have valid use cases where it makes sense to expose these classes? I'd love to see some input on this.
If we can't come up with valid use cases, I would suggest deprecating both classes for v2.x and removing them in v3.0 from our public API (which might mean marking them as @internal only). This way, we can reduce our API surface and are more in line with other promise implementations (e.g. ES6 promises). This simplifies our documentation and helps steering people to recommended usage patterns.
@mmoreram I have no plans to introduce any "deprecation message" (where should this be reported to?). Instead, I've marked both classes as deprecated via #165 for Promise v2 and both will be marked as internal via #164 for Promise v3.
Activity
WyriHaximus commentedon Dec 9, 2019
@clue I was kinda expecting this to be a PR I could instantly approve ❤️
jsor commentedon Dec 9, 2019
Those 2 classes have been implicitely made part of the public API with the 2.0 release by adding it to the documenttation (see #12).
It makes perfect sense to revert that, so 👍 from me.
mmoreram commentedon Mar 8, 2020
Would you introduce a deprecated message? I'm not really sure how to do it. Maybe looking for the caller?
clue commentedon Mar 8, 2020
@mmoreram I have no plans to introduce any "deprecation message" (where should this be reported to?). Instead, I've marked both classes as deprecated via #165 for Promise v2 and both will be marked as internal via #164 for Promise v3.
WyriHaximus commentedon Mar 8, 2020
Closing this as both PR's have been merged.
mmoreram commentedon Mar 8, 2020
@clue deprecation logs with flag
E_DEPRECATED