1927569 - Write JS topic guides for application-services components

Status: RESOLVED FIXED

(Application Services :: General, enhancement)

Description

[Ben Dean-Kawamura [:bdk]]

We currently have some for Kotlin and Swift, let's add some for JS.

One weird part of this is that the JS components expose a different threading model than Kotlin/Swift. Maybe we could change the note at the top of the components to say something like:

The SuggestStore is written in synchronous Rust.

• On Kotlin/Swift it needs to be wrapped in the asynchronous primitive of the target language you are using.
• On JS it's automatically wrapped to be asynchronous. In general, each function/method will be an asynchronous version of the sync Rust function, however there are some exceptions. Speak to the DISCO team for details.

I'm sure this could be rewritten better, but AFAICT it has to be a bit convoluted. I don't think that's a bad thing, it captures the current state of affairs correctly and one of the benefits of improving our async story is that we'll be able to simplify this note or maybe remove it altogether.

The code samples should also have awaits littered through them, unlike the other code samples.

Comment 1

[Ben Dean-Kawamura [:bdk]]

Attachment: Bug 1927569 - Rust component JS topic guides, r=bgruber

Comment 2

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/4c73e5fde8e2
Rust component JS topic guides, r=bgruber

Comment 3

[Sandor Molnar[:smolnar]]

https://hg.mozilla.org/mozilla-central/rev/4c73e5fde8e2