1424632 - Firefox for Android only supports a saveAs value of false

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: Add-ons, enhancement, P1)

Description

[dteviot]

:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: 57 Branch
 Technical Contact: 

:: Details

I use the Download API in my extension.  However, if saveAs is set to true, it doesn't work on Firefox for Android.  (It works on Windows.)
According to notes on https://bugzilla.mozilla.org/show_bug.cgi?id=1420744, Firefox for Android does not implement saveAs = true.  (Note, saveAs = false is supported.)

If this documentation mentioned this, it would have saved me some time.

Comment 1

[Irene Smith]

I updated the browser compatibility data to add a note that Firefox on Android ignores the parameter if it is set to false but raises an error if it is set to true. I didn't think it would be appropriate to add Firefox-specific information on a page that is supposed to be browser-agnostic, but would be happy to add a note if it is deemed necessary.

Pull request was created for BCD update.

Comment 2

[Chris Mills [:cmills]]

(In reply to Irene Smith from comment #1)
> I updated the browser compatibility data to add a note that Firefox on
> Android ignores the parameter if it is set to false but raises an error if
> it is set to true. I didn't think it would be appropriate to add
> Firefox-specific information on a page that is supposed to be
> browser-agnostic, but would be happy to add a note if it is deemed necessary.
> 
> Pull request was created for BCD update.

I think you should include a note — browser-agnostic doesn't mean that we can't mention Firefox, just that we should allow other browsers to document their platform-specific quirks too.

Comment 3

[Irene Smith]

(In reply to Chris Mills (Mozilla, MDN editor) [:cmills] from comment #2)
> (In reply to Irene Smith from comment #1)
> > I updated the browser compatibility data to add a note that Firefox on
> > Android ignores the parameter if it is set to false but raises an error if
> > it is set to true. I didn't think it would be appropriate to add
> > Firefox-specific information on a page that is supposed to be
> > browser-agnostic, but would be happy to add a note if it is deemed necessary.
> > 
> > Pull request was created for BCD update.
> 
> I think you should include a note — browser-agnostic doesn't mean that we
> can't mention Firefox, just that we should allow other browsers to document
> their platform-specific quirks too.

OK. Added a note:

Note: Firefox for Android raises an error if saveAs is set to true. The parameter is ignored when saveAs is false or not included.

Comment 4

[natthawut.m43.ptj]

+1