[jira] [Commented] (CB-4089) Undocumented API rule? Passing invalid option values uses default value instead.

["Peter (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CB-4089?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13887079#comment-13887079 ] 

Peter commented on CB-4089:
---------------------------

IMO it is incorrect to set component as "Globalization". This is a documentation issue. The Globalization API was just used as my example to illustrate it.

> Undocumented API rule? Passing invalid option values uses default value instead.
> --------------------------------------------------------------------------------
>
>                 Key: CB-4089
>                 URL: https://issues.apache.org/jira/browse/CB-4089
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: Docs, Plugin Globalization
>    Affects Versions: 2.7.0
>            Reporter: Peter
>            Assignee: Michael Brooks
>            Priority: Minor
>
> It looks like there is some undocumented rule such that if an _invalid_ option value is passed via a Cordova API then the _default_ value will be used instead.
> For example, the following calls are all equaivalent:
> {code}
> navigator.globalization.dateToString(new Date(), win, fail, {selector: 'banana'}) 
> navigator.globalization.dateToString(new Date(), win, fail, {selector: 'date and time'}) 
> navigator.globalization.dateToString(new Date(), win, fail, {}) 
> {code}
> I had (wrongly) expected 'banana' would result in some kind of API error since it is not a supported value for the selector.
> This undocumented API rule should be documented.



--
This message was sent by Atlassian JIRA
(v6.1.5#6160)