feature (GH-128) ios/android: enable programmatic dismissal of open dialogs. Resolves #128.

[dpa99c]

Platforms affected

iOS and Android

Motivation and Context

Enables programmatic dismissal of currently open dialogs. Example use case is where a dialog is opened but the context for the dialog changes in real-time so the dialog is no longer relevant.

Resolves #128 and supersedes #79.

Description

Two new plugin API methods have been added:

• dismissPrevious() - dismisses the dialog that was most recently opened
• dismissAll() - dismisses all open dialogs

Both functions take successCallback and errorCallback arguments:

• successCallback is invoked when one or more previously opened dialogs has been dismissed
• errorCallback is invoked if no previously opened dialogs exist to dismiss

Testing

• A test harness Cordova project has been created - build+run iOS/Android platform to test new API methods: https://github.com/dpa99c/cordova-plugin-dialogs-test
• Automated tests have been updated to test the for existence of new API methods
• Manual tests have been updated to test both new API methods

Checklist

• [x] I've run the tests to see all new and existing tests pass
• [x] I added automated test coverage as appropriate for this change
• [x] Commit is prefixed with (platform) if this change only applies to one platform (e.g. (android))
• [x] If this Pull Request resolves an issue, I linked to the issue in the text above (and used the correct keyword to close issues using keywords)
• [x] I've updated the documentation if necessary

[dpa99c]

Travis CI browser platform tests are failing for some reason but I don't think it's related to changes made by this PR

[timbru31]

Yeah we've got an issue in paramedic that causes the failure.