Electron Releases

Description of Change

• webContents.print()'s argument and pageSize handling, webContents/webFrameMain printToPDF()'s option validation and per-frame-tree job queue (lib/browser/print-to-pdf.ts), and getPrintersAsync() are now the native methods themselves rather than JS wrappers over _print/_printToPDF. Defaults, validation order, messages and Error/TypeError/RangeError classes are kept (down to JS <= coercion for the margins check and which getters run).
• New gin_helper::ConversionError (why a conversion failed, at which property path, and which JS error class to raise) and gin_helper::OptionsReader (reads an options object property by property through gin's converters or a converter that takes the ConversionError; undefined/null count as absent; stops at the first failure) so native option parsing can report "margins.top must be a number" instead of gin's generic conversion error.

Intentional differences: printToPDF(undefined | null | <primitive>) rejects with options must be an object; a PDF job whose WebContents goes away while queued rejects instead of never settling; getPrintersAsync() and printToPDF() on a destroyed WebContents reject rather than throw.

~290 lines out of lib/; no runtime change intended.

Checklist

• I have built and tested this change
• I have filled out the PR description
• I have reviewed and verified the changes
• npm test passes
• PR release notes describe the change in a way relevant to app developers, and are capitalized, punctuated, and past tense.

Release Notes

Notes: none