This is right: "The mozbrowseractivitydone event is fired when something inside the browser <iframe> triggers a web activity, and that web activity's message is consumed by the receiving app."
But could benefit like an addendum like: For activities where the servicing app's activity definition in its manifest does not include returnValue or returnValue is false, no mozbrowseractivitydone event will be generated as of the landing of https://bugzilla.mozilla.org/show_bug.cgi?id=1194525 in v2.5. postResult and postError calls made on the activity will be ignored and have no effect. This is probably misleading: "For example, if you want to share a picture displayed inside the browser via email, the event is fired once the email has been successfully sent via the email app." Specifically, the email app tries to asynchronously send messages in the background and really just consumes the activity when it wants the window manager to foreground the calling app again. It might make sense to just drop that sentence and instead elaborate on what we mean by consume: A returnValue=true activity is consumed when postResult or postError is invoked on the activity by the servicing app. Hope that helps / keep up the great documentin'! Andrew On Mon, Nov 16, 2015, at 08:55 AM, Chris Mills wrote: > hi there, > > I’ve recently been updating the MDN Browser API documentation (see [0]), > and I had a few questions tat I couldn’t easily find the answers for: > > 1. Does this description sound correct: > https://developer.mozilla.org/en-US/docs/Web/Events/mozbrowseractivitydone > ? I kinda guessed the functionality of this one. > > 2. Also, for mozbrowserselectionstatechanged, what values can the > event.details.states property take? > > Thanks in advance, > > Chris Mills > Senior tech writer || Mozilla > developer.mozilla.org || MDN > [email protected] || @chrisdavidmills > > _______________________________________________ > dev-fxos mailing list > [email protected] > https://lists.mozilla.org/listinfo/dev-fxos _______________________________________________ dev-fxos mailing list [email protected] https://lists.mozilla.org/listinfo/dev-fxos
