Skip to content

fix: ensure docs include @returns Promise<void> where appropriate - #3954

Merged
kobenguyent merged 1 commit into
codeceptjs:3.xfrom
fwouts:fix-mustache-promise-returns
Oct 28, 2023
Merged

fix: ensure docs include @returns Promise<void> where appropriate#3954
kobenguyent merged 1 commit into
codeceptjs:3.xfrom
fwouts:fix-mustache-promise-returns

Conversation

@fwouts

@fwouts fwouts commented Oct 27, 2023

Copy link
Copy Markdown
Contributor

Motivation/Description of the PR

This PR fixes the generated typings/types.d.ts definitions for methods that use Mustache docs. The intention is similar to #3465, but it fixes the original helper types instead.

Note that there are still various methods that aren't typed properly, such as Playwright._getPageUrl() (currently typed as void), because they are missing @return JSDoc annotations. This should also be fixed, although it may make more sense to do this in a separate PR to keep this one focused.

This fixes #3324.

Applicable helpers:

  • Playwright
  • Puppeteer
  • WebDriver
  • REST
  • FileHelper
  • Appium
  • TestCafe

Type of change

  • 🔥 Breaking changes
  • 🚀 New functionality
  • 🐛 Bug fix
  • 📋 Documentation changes/updates
  • ♨️ Hot fix
  • 🔨 Markdown files fix - not related to source code
  • 💅 Polish code

Checklist:

  • Tests have been added updated
  • Documentation has been added (Run npm run docs)
  • Lint checking (Run npm run lint)
  • Local tests are passed (Run npm test)

@kobenguyent kobenguyent added documentation typescript Changes for typings or typescript compatibility labels Oct 27, 2023
@kobenguyent

Copy link
Copy Markdown
Collaborator

Thank you @fwouts

@kobenguyent
kobenguyent merged commit 8b721ca into codeceptjs:3.x Oct 28, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation typescript Changes for typings or typescript compatibility

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Discrepancies between code documentation online and the NPM package

2 participants