Skip to content

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

Closed
benjamingr wants to merge 3 commits into
nodejs:masterfrom
benjamingr:filehandle-doc-changes
Closed

doc: warn about relying on fs gc close behavior#27972
benjamingr wants to merge 3 commits into
nodejs:masterfrom
benjamingr:filehandle-doc-changes

Conversation

@benjamingr

Copy link
Copy Markdown
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 jasnellMay 30, 2019 10:23
@benjamingrbenjamingr added the fs Issues and PRs related to the fs subsystem / file system. label May 30, 2019
Comment threaddoc/api/fs.md Outdated
Comment threaddoc/api/fs.md Outdated
@littledan

Copy link
Copy Markdown

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/ .

benjamingrand 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
Copy Markdown
Member

@TrottTrott 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

Trott commented Jun 1, 2019

Copy link
Copy Markdown
Member

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>
@TrottTrott 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>
@targostargos mentioned this pull request Jun 3, 2019
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs that have at least one approval, no pending requests for changes, and a CI started.fsIssues and PRs related to the fs subsystem / file system.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants

@benjamingr@littledan@Trott@jasnell@addaleax@antsmartian@lpinca@cjihrig