Skip to content

doc: add missing options.info for BrotliOptions #58359

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

Conversation

hkleungai
Copy link
Contributor

Source code of function Brotli() calls ctor of parent ZlibBase via
ReflectApply()

By inspecting opts in ZlibBase ctor, we can see opts?.info is
further used to determine the return shapes of *Sync() methods in
children class. This information will need to be revealed in nodejs doc.

This PR is separated from the one for ZstdOptions, since these two
changes potentially need to be backported to different minimum versions.

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. zlib Issues and PRs related to the zlib subsystem. labels May 16, 2025
Source code of `function Brotli()` calls ctor of parent `ZlibBase` via
`ReflectApply()`

By inspecting `opts` in `ZlibBase` ctor, we can see `opts?.info` is
further used to determine the return shapes of `*Sync()` methods in
children class. This information will need to be revealed in nodejs doc.

This PR is separated from the one for `ZstdOptions`, since these two
changes potentially need to be backported to different minimum versions.
@hkleungai hkleungai force-pushed the doc-api-zlib-add-missing-BrotliOptions.info branch from 76511de to dabc311 Compare May 28, 2025 17:48
@aduh95 aduh95 added author ready PRs that have at least one approval, no pending requests for changes, and a CI started. commit-queue Add this label to land a pull request using GitHub Actions. labels May 28, 2025
@nodejs-github-bot nodejs-github-bot removed the commit-queue Add this label to land a pull request using GitHub Actions. label May 28, 2025
@nodejs-github-bot nodejs-github-bot merged commit e71a3ce into nodejs:main May 28, 2025
22 checks passed
@nodejs-github-bot
Copy link
Collaborator

Landed in e71a3ce

@hkleungai hkleungai deleted the doc-api-zlib-add-missing-BrotliOptions.info branch May 30, 2025 19:00
targos pushed a commit that referenced this pull request May 31, 2025
Source code of `function Brotli()` calls ctor of parent `ZlibBase` via
`ReflectApply()`

By inspecting `opts` in `ZlibBase` ctor, we can see `opts?.info` is
further used to determine the return shapes of `*Sync()` methods in
children class. This information will need to be revealed in nodejs doc.

This PR is separated from the one for `ZstdOptions`, since these two
changes potentially need to be backported to different minimum versions.

PR-URL: #58359
Reviewed-By: Antoine du Hamel <[email protected]>
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. doc Issues and PRs related to the documentations. zlib Issues and PRs related to the zlib subsystem.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants