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

Flesh out DOM interaction helper documentation. #287

Merged
merged 12 commits into from
Dec 29, 2017

Conversation

rwjblue
Copy link
Member

@rwjblue rwjblue commented Dec 27, 2017

No description provided.

@method click
@param {String|Element} target
@return {Promise<void>}
Clicks on the specified selector.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"specified target" might be better

@returns {Event}

@private
*/
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why did you remove these? They might still be useful for type info

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, unless we are going to type check ember-test-helpers internally, I don't think this provides any value. This entire file is private and only used to expose the actual public API's which do have valid type information...

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some IDEs are able to parse these comments and provide hints. Might be useful for future contributors.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, will bring it back for the export (but not the inner / private helper functions)

@@ -13,16 +13,18 @@ const DEFAULT_MODIFIERS = Object.freeze({
});

/**
Triggers a keyboad event on the specified selector.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Keyboard

@rwjblue rwjblue merged commit 65d741a into emberjs:master Dec 29, 2017
@rwjblue rwjblue deleted the documentation-updates branch December 29, 2017 14:22
@rwjblue rwjblue mentioned this pull request Dec 29, 2017
2 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants