Skip to content

timers: deprecate active() and _unrefActive() - #26760

Closed
Fishrock123 wants to merge 1 commit into
nodejs:masterfrom
Fishrock123:timers-active-deprecation
Closed

timers: deprecate active() and _unrefActive()#26760
Fishrock123 wants to merge 1 commit into
nodejs:masterfrom
Fishrock123:timers-active-deprecation

Conversation

@Fishrock123

@Fishrock123Fishrock123 commented Mar 18, 2019•
edited
Loading

Copy link
Copy Markdown
Contributor

Another nail in the coffin here, farewell ye ol C-style apis.

These apis caused numerous other issues that required far too many safeguards.
This gets us one step closer to not having to worry about those issues anymore.

Refs: #18066
Refs: #20298

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • tests and/or benchmarks are included
  • documentation is changed or added
  • commit message follows commit guidelines

@nodejs-github-bot

nodejs-github-bot commented Mar 18, 2019

Copy link
Copy Markdown
Collaborator

@Fishrock123 build started: https://ci.nodejs.org/blue/organizations/jenkins/node-test-pull-request-lite-pipeline/detail/node-test-pull-request-lite-pipeline/2976/pipeline

@nodejs-github-botnodejs-github-bot added the timers Issues and PRs related to the timers subsystem / setImmediate, setInterval, setTimeout. label Mar 18, 2019
@Fishrock123
Fishrock123force-pushed the timers-active-deprecation branch from 67a522f to 41d48d7CompareMarch 18, 2019 23:05
@Fishrock123Fishrock123 added author ready PRs that have at least one approval, no pending requests for changes, and a CI started. and removed author ready PRs that have at least one approval, no pending requests for changes, and a CI started. labels Mar 18, 2019
mscdex
mscdex reviewed Mar 18, 2019
View reviewed changes
Comment threaddoc/api/deprecations.md Outdated
mscdex
mscdex reviewed Mar 18, 2019
View reviewed changes
Comment threaddoc/api/deprecations.md Outdated

@mscdexmscdexMar 18, 2019•
edited
Loading

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does timers._unrefActive() really do the same thing as timeout.refresh()? Shouldn't we only be recommending timeout.unref() as a replacement?

@Fishrock123Fishrock123Mar 19, 2019

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's an awkward combination of both. It is essentially "refresh this timer as unrefed". Active is the same, but refed.

Perhaps there was an extra meaning back when {un}ref() made separate libuv handles. I'm not sure but that doesn't exist anymore regardless.

@Fishrock123
Fishrock123force-pushed the timers-active-deprecation branch from 41d48d7 to 696a869CompareMarch 19, 2019 00:06
vsemozhetbyt
vsemozhetbyt reviewed Mar 19, 2019
View reviewed changes
Comment threaddoc/api/deprecations.md Outdated

@vsemozhetbytvsemozhetbytMar 19, 2019

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be DEP0XXX till landing (here, below and in the next section)?

@Fishrock123Fishrock123Mar 19, 2019•
edited
Loading

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does it really matter? ¯\_(ツ)_/¯

So long as it's updated if necessary at landing...

Comment threaddoc/api/deprecations.md Outdated
Comment threaddoc/api/deprecations.md Outdated
@Fishrock123
timers: deprecate active() and _unrefActive()
1b80a2b
Another nail in the coffin here, farewell ye ol C-style apis.
These apis caused numerous other issues that required far too many
safeguards. This gets us one step closer to not having to worry about
those issues anymore.
Refs: nodejs#18066
Refs: nodejs#20298
PR-URL: nodejs#26760
@Fishrock123
Fishrock123force-pushed the timers-active-deprecation branch from 696a869 to 1b80a2bCompareMarch 19, 2019 18:14
@richardlaurichardlau added the deprecations Issues and PRs related to deprecations. label Mar 19, 2019
@Fishrock123Fishrock123 added the semver-minor PRs that contain new features and should be released in the next minor version. label Mar 20, 2019
@Fishrock123

Fishrock123 commented Mar 20, 2019

Copy link
Copy Markdown
ContributorAuthor

@nodejs/tsc I would like approval to land this as semver-minor, just like the related former pr: #20298, considering it deprecates undocumented methods.

mcollina
mcollina approved these changes Mar 21, 2019
View reviewed changes

@mcollinamcollina left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

apapirovski
apapirovski approved these changes Mar 21, 2019
View reviewed changes

@apapirovskiapapirovski left a comment •
edited
Loading

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In favor of semver-minor.

@BridgeAR

BridgeAR commented Mar 21, 2019

Copy link
Copy Markdown
Member

CI https://ci.nodejs.org/job/node-test-pull-request/21746/

@Fishrock123 just as a note: this was not author-ready until now (our guidelines say the CI has to be triggered and AFAIK the lite CI does not count in this case).

This was referenced Mar 22, 2019
Closed
Closed
@Fishrock123

Fishrock123 commented Mar 23, 2019

Copy link
Copy Markdown
ContributorAuthor

@BridgeAR Oh, whoops. Will remember for next time. This LG to you now? CI is happy.

@BridgeAR

BridgeAR commented Mar 23, 2019

Copy link
Copy Markdown
Member

@Fishrock123 yes, this is still LGTM.

Fishrock123 added a commit to Fishrock123/node that referenced this pull request Mar 23, 2019
@Fishrock123
timers: deprecate active() and _unrefActive()
7c80f18
Another nail in the coffin here, farewell ye ol C-style apis.
These apis caused numerous other issues that required far too many
safeguards. This gets us one step closer to not having to worry about
those issues anymore.
Refs: nodejs#18066
Refs: nodejs#20298
PR-URL: nodejs#26760
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Anatoli Papirovski <apapirovski@mac.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
@Fishrock123

Fishrock123 commented Mar 23, 2019

Copy link
Copy Markdown
ContributorAuthor

Landed in 7c80f18

@Fishrock123
Fishrock123 deleted the timers-active-deprecation branch March 23, 2019 02:59
targos pushed a commit that referenced this pull request Mar 28, 2019
@Fishrock123@targos
timers: deprecate active() and _unrefActive()
fb83505
Another nail in the coffin here, farewell ye ol C-style apis.
These apis caused numerous other issues that required far too many
safeguards. This gets us one step closer to not having to worry about
those issues anymore.
Refs: #18066
Refs: #20298
PR-URL: #26760
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Anatoli Papirovski <apapirovski@mac.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
targos pushed a commit that referenced this pull request Mar 30, 2019
@Fishrock123@targos
timers: deprecate active() and _unrefActive()
b24e45a
Another nail in the coffin here, farewell ye ol C-style apis.
These apis caused numerous other issues that required far too many
safeguards. This gets us one step closer to not having to worry about
those issues anymore.
Refs: #18066
Refs: #20298
PR-URL: #26760
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Anatoli Papirovski <apapirovski@mac.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
@BethGriggsBethGriggs mentioned this pull request Apr 9, 2019
Merged
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@mcollinamcollinamcollina approved these changes
@joyeecheungjoyeecheungjoyeecheung approved these changes
@BridgeARBridgeARBridgeAR approved these changes
+3 more reviewers
@mscdexmscdexmscdex left review comments
@vsemozhetbytvsemozhetbytvsemozhetbyt left review comments
@apapirovskiapapirovskiapapirovski approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

author readyPRs that have at least one approval, no pending requests for changes, and a CI started.deprecationsIssues and PRs related to deprecations.semver-minorPRs that contain new features and should be released in the next minor version.timersIssues and PRs related to the timers subsystem / setImmediate, setInterval, setTimeout.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

10 participants

@Fishrock123@nodejs-github-bot@BridgeAR@apapirovski@mcollina@mscdex@joyeecheung@vsemozhetbyt@richardlau@BethGriggs