Skip to content

feat:Add publish events over websocket docs #8270

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

Merged
merged 3 commits into from
Mar 14, 2025

Conversation

zxl629
Copy link
Contributor

@zxl629 zxl629 commented Feb 25, 2025

Description of changes:

Add examples of publishing events over WebSocket to the docs, this change aligns with the feature addition in this PR

Related GitHub issue #, if available:

Instructions

If this PR should not be merged upon approval for any reason, please submit as a DRAFT

Which product(s) are affected by this PR (if applicable)?

  • amplify-cli
  • amplify-ui
  • amplify-studio
  • amplify-hosting
  • amplify-libraries

Which platform(s) are affected by this PR (if applicable)?

  • JS
  • Swift
  • Android
  • Flutter
  • React Native

Please add the product(s)/platform(s) affected to the PR title

Checks

  • Does this PR conform to the styleguide?

  • Does this PR include filetypes other than markdown or images? Please add or update unit tests accordingly.

  • Are any files being deleted with this PR? If so, have the needed redirects been created?

  • Are all links in MDX files using the MDX link syntax rather than HTML link syntax?

    ref: MDX: [link](https://docs.amplify.aws/)
    HTML: <a href="https://docs.amplify.aws/">link</a>

When this PR is ready to merge, please check the box below

  • Ready to merge

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@zxl629 zxl629 requested a review from josefaidt as a code owner February 25, 2025 19:13
@@ -83,6 +83,10 @@ export default function App() {

async function publishEvent() {
await events.post('default/channel', { some: 'data' });

//Alternative way to publish events through the channel
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
//Alternative way to publish events through the channel
// Alternative way to publish events through the channel

Copy link
Contributor

Choose a reason for hiding this comment

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

tiny nit to align comment styles

@@ -241,6 +245,10 @@ export default function App() {

async function publishEvent() {
await events.post('default/channel', { some: 'data' });

//Alternative way to publish events through the channel
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
//Alternative way to publish events through the channel
// Alternative way to publish events through the channel

Comment on lines 85 to 89
await events.post('default/channel', { some: 'data' });

// Alternative way to publish events through the channel
const channel = await events.connect('default/channel');
await channel.publish({ some: 'data' });
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
await events.post('default/channel', { some: 'data' });
// Alternative way to publish events through the channel
const channel = await events.connect('default/channel');
await channel.publish({ some: 'data' });
// publish via HTTP POST
await events.post('default/channel', { some: 'data' });
// Alternatively, publish events through the WebSocket channel
const channel = await events.connect('default/channel');
await channel.publish({ some: 'data' });

looking at the content changes again I think it would be helpful to describe the differences between these two options. Although the API is clear in its intentions with .post(), adding a note will provide additional clarity especially when evaluating the alternative

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This makes sense, I have added a note for each option to clarify for the users.

@zxl629 zxl629 merged commit 8e6a250 into main Mar 14, 2025
12 checks passed
@zxl629 zxl629 deleted the update/websocket-publish-event branch March 14, 2025 00:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants