Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: warn about relying on fs gc close behavior #27972

Closed
wants to merge 3 commits into from

Conversation

benjamingr
Copy link
Member

Warn about using the bahavior where file handles are closed automatically when the file is closed.

ping @jasnell @littledan

  • 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

Warn about using the bahvior where file handles are closed automatically
when the file is closed.

PR-URL:
Reviewed-By:
Reviewed-By:
@benjamingr benjamingr requested a review from jasnell May 30, 2019 10:23
@benjamingr benjamingr added the fs Issues and PRs related to the fs subsystem / file system. label May 30, 2019
doc/api/fs.md Outdated Show resolved Hide resolved
doc/api/fs.md Outdated Show resolved Hide resolved
@littledan
Copy link

Thanks for this clarification. I think it's important that people understand that using finalizers is unreliable, and that they don't develop too strong expectations. For more context, see https://github.com/tc39/proposal-weakrefs/ .

benjamingr and others added 2 commits May 30, 2019 15:07
Co-Authored-By: Rich Trott <rtrott@gmail.com>
Co-Authored-By: Rich Trott <rtrott@gmail.com>
@Trott
Copy link
Member

Trott commented May 30, 2019

@Trott Trott added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label May 30, 2019
@Trott
Copy link
Member

Trott commented Jun 1, 2019

Landed in 4c2345f

Trott pushed a commit to Trott/io.js that referenced this pull request Jun 1, 2019
Warn about using the bahvior where file handles are closed automatically
when the file is closed.

PR-URL: nodejs#27972
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Anto Aravinth <anto.aravinth.cse@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
@Trott Trott closed this Jun 1, 2019
targos pushed a commit that referenced this pull request Jun 1, 2019
Warn about using the bahvior where file handles are closed automatically
when the file is closed.

PR-URL: #27972
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Anto Aravinth <anto.aravinth.cse@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
@targos targos mentioned this pull request Jun 3, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
author ready PRs that have at least one approval, no pending requests for changes, and a CI started. fs Issues and PRs related to the fs subsystem / file system.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants