Check overload tag against implementation#52474
Merged
sandersn merged 10 commits intomicrosoft:mainfrom Feb 16, 2023
Merged
Conversation
Also, make @overload work like other jsdoc tags: only the last jsdoc tag before a declaration is used. That means all overload tags need to be in one tag: ```js /** * @overload * @return {number} * * @overload * @return {string} */ ``` function f() { return "1" } This no longer works: ```js /** * @overload * @return {number} */ /** * @overload * @return {string} */ function f() { return "2" } ``` Fixes microsoft#51234
Member
|
Looks like you'll need to merge from |
DanielRosenwasser
approved these changes
Feb 14, 2023
Member
DanielRosenwasser
left a comment
There was a problem hiding this comment.
Looks good - though the placement of the test is weird.
5 tasks
Member
|
Main is failing after this has been merged; some conflict? |
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Edit: It turns out that the semantics below only work for overloads that specify a return type. Otherwise the parser doesn't know where the last
@overloadends if it's missing@return. WhilenoImplicitAnyprompts to add@return, it's off in most JS scenarios.I'm still not happy that we're encouraging people to split their tags, but I don't see a good way around it.
Nope, Below Idea Doesn't Work
Also, make @overload work like other jsdoc tags: only the last jsdoc tag
before a declaration is used. That means all overload tags need to be in
one tag:
function f() { return "1" }
This no longer works:
@DanielRosenwasser this is a break from what is described in the beta blog post, but I really want
@overloadto work the same way as the rest of our jsdoc tags. At the time I changed the existing tag's behaviour, I found that almost nobody split their tags out this way, so I don't want to encourage people to start.Fixes #52367
Followup to #51234