Anadiendo el codigo de contactos aunque no funciona

.vscode/launch.json

+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Run Android on device",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "android",
+            "target": "device",
+            "port": 9222,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}",
+            "ionicLiveReload": false
+        },
+        {
+            "name": "Run iOS on device",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "ios",
+            "target": "device",
+            "port": 9220,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}",
+            "ionicLiveReload": false
+        },
+        {
+            "name": "Attach to running android on device",
+            "type": "cordova",
+            "request": "attach",
+            "platform": "android",
+            "target": "device",
+            "port": 9222,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "Attach to running iOS on device",
+            "type": "cordova",
+            "request": "attach",
+            "platform": "ios",
+            "target": "device",
+            "port": 9220,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "Run Android on emulator",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "android",
+            "target": "emulator",
+            "port": 9222,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}",
+            "ionicLiveReload": false
+        },
+        {
+            "name": "Attach to running android on emulator",
+            "type": "cordova",
+            "request": "attach",
+            "platform": "android",
+            "target": "emulator",
+            "port": 9222,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "Serve to the browser (ionic serve)",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "serve",
+            "cwd": "${workspaceFolder}",
+            "devServerAddress": "localhost",
+            "sourceMaps": true,
+            "ionicLiveReload": true
+        },
+        {
+            "name": "Simulate Android in browser",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "android",
+            "target": "chrome",
+            "simulatePort": 8000,
+            "livereload": true,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "Simulate iOS in browser",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "ios",
+            "target": "chrome",
+            "simulatePort": 8000,
+            "livereload": true,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}"
+        },
+        {
+            "name": "Run Browser",
+            "type": "cordova",
+            "request": "launch",
+            "platform": "browser",
+            "target": "chrome",
+            "simulatePort": 8000,
+            "livereload": true,
+            "sourceMaps": true,
+            "cwd": "${workspaceFolder}"
+        }
+    ]
+}

km0App/.gradle/buildOutputCleanup/cache.properties

+#Thu Oct 24 08:46:16 AST 2019
+gradle.version=5.6.2

km0App/.vscode/plugins.json

+{"plugins":["cordova-plugin-whitelist","cordova-plugin-contacts"]}

km0App/.vscode/typings/cordova/cordova.d.ts

+// Type definitions for Apache Cordova
+// Project: http://cordova.apache.org
+// Definitions by: Microsoft Open Technologies Inc. <http://msopentech.com>
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+//
+// Copyright (c) Microsoft Open Technologies, Inc.
+// Licensed under the MIT license.
+
+interface Cordova {
+    /** Invokes native functionality by specifying corresponding service name, action and optional parameters.
+     * @param success A success callback function.
+     * @param fail An error callback function.
+     * @param service The service name to call on the native side (corresponds to a native class).
+     * @param action The action name to call on the native side (generally corresponds to the native class method).
+     * @param args An array of arguments to pass into the native environment.
+     */
+    exec(success: () => any, fail: () => any, service: string, action: string, args?: string[]): void;
+    /** Gets the operating system name. */
+    platformId: string;
+    /** Gets Cordova framework version */
+    version: string;
+    /** Defines custom logic as a Cordova module. Other modules can later access it using module name provided. */
+    define(moduleName: string, factory: (require: any, exports: any, module: any) => any): void;
+    /** Access a Cordova module by name. */
+    require(moduleName: string): any;
+    /** Namespace for Cordova plugin functionality */
+    plugins:CordovaPlugins;
+}
+
+interface CordovaPlugins {}
+
+interface Document {
+    addEventListener(type: "deviceready", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "pause", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "resume", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "backbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "menubutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "searchbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "startcallbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "endcallbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "volumedownbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    addEventListener(type: "volumeupbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+
+    removeEventListener(type: "deviceready", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "pause", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "resume", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "backbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "menubutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "searchbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "startcallbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "endcallbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "volumedownbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: "volumeupbutton", listener: (ev: Event) => any, useCapture?: boolean): void;
+
+    addEventListener(type: string, listener: (ev: Event) => any, useCapture?: boolean): void;
+    removeEventListener(type: string, listener: (ev: Event) => any, useCapture?: boolean): void;
+}
+
+interface Window {
+  cordova:Cordova;
+}
+
+// cordova/argscheck module
+interface ArgsCheck {
+    checkArgs(argsSpec: string, functionName: string, args: any[], callee?: any): void;
+    getValue(value?: any, defaultValue?: any): any;
+    enableChecks: boolean;
+}
+
+// cordova/urlutil module
+interface UrlUtil {
+    makeAbsolute(url: string): string
+}
+
+/** Apache Cordova instance */
+declare var cordova: Cordova;
+
+declare module 'cordova' {
+    export = cordova;
+}

km0App/jsconfig.json

+{}

km0App/node_modules/cordova-android/package.json

   "_location": "/cordova-android",
   "_phantomChildren": {},
   "_requested": {
-    "type": "range",
-    "registry": true,
-    "raw": "cordova-android@^8.0.0",
-    "name": "cordova-android",
     "escapedName": "cordova-android",
+    "fetchSpec": "^8.0.0",
+    "name": "cordova-android",
+    "raw": "cordova-android@^8.0.0",
     "rawSpec": "^8.0.0",
+    "registry": true,
     "saveSpec": null,
-    "fetchSpec": "^8.0.0"
+    "type": "range"
   },
   "_requiredBy": [
     "#USER",
   "homepage": "https://github.com/apache/cordova-android#readme",
   "keywords": [
     "android",
-    "cordova",
-    "apache"
+    "apache",
+    "cordova"
   ],
   "license": "Apache-2.0",
   "main": "bin/templates/cordova/Api.js",
       "text"
     ]
   },
+  "optionalDependencies": {},
+  "readme": "<!--\n#\n# Licensed to the Apache Software Foundation (ASF) under one\n# or more contributor license agreements.  See the NOTICE file\n# distributed with this work for additional information\n# regarding copyright ownership.  The ASF licenses this file\n# to you under the Apache License, Version 2.0 (the\n# \"License\"); you may not use this file except in compliance\n# with the License.  You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing,\n# software distributed under the License is distributed on an\n# \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n#  KIND, either express or implied.  See the License for the\n# specific language governing permissions and limitations\n# under the License.\n#\n-->\n\n[![Build status](https://ci.appveyor.com/api/projects/status/github/apache/cordova-android?branch=master)](https://ci.appveyor.com/project/Humbedooh/cordova-android)\n[![Build Status](https://travis-ci.org/apache/cordova-android.svg?branch=master)](https://travis-ci.org/apache/cordova-android)\n[![codecov.io](https://codecov.io/github/apache/cordova-android/coverage.svg?branch=master)](https://codecov.io/github/apache/cordova-android?branch=master)\n\n# Cordova Android\n\nCordova Android is an Android application library that allows for Cordova-based\nprojects to be built for the Android Platform. Cordova based applications are,\nat the core, applications written with web technology: HTML, CSS and JavaScript.\n\n[Apache Cordova](https://cordova.apache.org) is a project of The Apache Software Foundation (ASF).\n\n## Requires\n\n- Java JDK 1.8 or greater\n- Android SDK [http://developer.android.com](http://developer.android.com)\n\n\n## Cordova Android Developer Tools\n\nWe recommend using the [Cordova command-line tool](https://www.npmjs.com/package/cordova) to create projects and be able to easily install plugins.\n\nHowever, the following scripts can be used instead:\n\n    ./bin/create [path package activity] ... creates the ./example app or a cordova android project\n    ./bin/check_reqs ....................... checks that your environment is set up for cordova-android development\n    ./bin/update [path] .................... updates an existing cordova-android project to the version of the framework\n\nThese commands live in a generated Cordova Android project. Any interactions with the emulator require you to have an AVD defined.\n\n    ./cordova/clean ........................ cleans the project\n    ./cordova/build ........................ calls `clean` then compiles the project\n    ./cordova/log   ........................ streams device or emulator logs to STDOUT\n    ./cordova/run   ........................ calls `build` then deploys to a connected Android device. If no Android device is detected, will launch an emulator and deploy to it.\n    ./cordova/version ...................... returns the cordova-android version of the current project\n\n## Using Android Studio\n\n1. Create a project\n2. Import it via \"Non-Android Studio Project\"\n\n## Running the Native Tests\n\nThe `test/` directory in this project contains an Android test project that can\nbe used to run different kinds of native tests. Check out the\n[README contained therein](test/README.md) for more details!\n",
+  "readmeFilename": "README.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/apache/cordova-android.git"

km0App/node_modules/cordova-browser/package.json

   "_location": "/cordova-browser",
   "_phantomChildren": {},
   "_requested": {
-    "type": "range",
-    "registry": true,
-    "raw": "cordova-browser@^6.0.0",
-    "name": "cordova-browser",
     "escapedName": "cordova-browser",
+    "fetchSpec": "^6.0.0",
+    "name": "cordova-browser",
+    "raw": "cordova-browser@^6.0.0",
     "rawSpec": "^6.0.0",
+    "registry": true,
     "saveSpec": null,
-    "fetchSpec": "^6.0.0"
+    "type": "range"
   },
   "_requiredBy": [
     "#USER",
   },
   "homepage": "https://github.com/apache/cordova-browser#readme",
   "keywords": [
-    "cordova",
+    "apache",
     "browser",
-    "apache"
+    "cordova"
   ],
   "license": "Apache-2.0",
   "main": "bin/template/cordova/Api.js",
       "text"
     ]
   },
+  "optionalDependencies": {},
+  "readme": "<!--\n#\n# Licensed to the Apache Software Foundation (ASF) under one\n# or more contributor license agreements.  See the NOTICE file\n# distributed with this work for additional information\n# regarding copyright ownership.  The ASF licenses this file\n# to you under the Apache License, Version 2.0 (the\n# \"License\"); you may not use this file except in compliance\n# with the License.  You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing,\n# software distributed under the License is distributed on an\n# \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n#  KIND, either express or implied.  See the License for the\n# specific language governing permissions and limitations\n# under the License.\n#\n-->\n\n[![Build status](https://travis-ci.org/apache/cordova-browser.svg?branch=master )](https://travis-ci.org/apache/cordova-browser.svg?branch=master )\n[![Build Status](https://ci.appveyor.com/api/projects/status/4oan2jjn7nlgfay3/branch/master?svg=true)](https://ci.appveyor.com/api/projects/status/4oan2jjn7nlgfay3/branch/master?svg=true)\n\n# Cordova Browser\n\nTarget modern web browsers to build Apache Cordova based applications.\n\n# Goals\n\n- Browser targeted deployment\n- Surfacing native platform incompatibilities from the open web platform\n\n# PWA support\n\n## cordova-browser now includes support for progressive web apps (PWAs)\n\n- if your project supplies a `manifest.json` in the `www/` dir, it will be used\n    - a `manifest.json` will be generated otherwise\n- if your js code registers a service worker, it will also be used\n\n\n",
+  "readmeFilename": "README.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/apache/cordova-browser.git"

km0App/node_modules/cordova-ios/package.json

   "_location": "/cordova-ios",
   "_phantomChildren": {},
   "_requested": {
-    "type": "range",
-    "registry": true,
-    "raw": "cordova-ios@^5.0.0",
-    "name": "cordova-ios",
     "escapedName": "cordova-ios",
+    "fetchSpec": "^5.0.0",
+    "name": "cordova-ios",
+    "raw": "cordova-ios@^5.0.0",
     "rawSpec": "^5.0.0",
+    "registry": true,
     "saveSpec": null,
-    "fetchSpec": "^5.0.0"
+    "type": "range"
   },
   "_requiredBy": [
     "#USER",
   },
   "homepage": "https://github.com/apache/cordova-ios#readme",
   "keywords": [
-    "ios",
-    "cordova",
     "apache",
+    "cordova",
+    "cordova:platform",
     "ecosystem:cordova",
-    "cordova:platform"
+    "ios"
   ],
   "license": "Apache-2.0",
   "main": "bin/templates/scripts/cordova/Api.js",
       "text"
     ]
   },
+  "optionalDependencies": {},
+  "readme": "<!--\n#\n# Licensed to the Apache Software Foundation (ASF) under one\n# or more contributor license agreements.  See the NOTICE file\n# distributed with this work for additional information\n# regarding copyright ownership.  The ASF licenses this file\n# to you under the Apache License, Version 2.0 (the\n# \"License\"); you may not use this file except in compliance\n# with the License.  You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing,\n# software distributed under the License is distributed on an\n# \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n#  KIND, either express or implied.  See the License for the\n# specific language governing permissions and limitations\n# under the License.\n#\n-->\n\n[![Build status](https://ci.appveyor.com/api/projects/status/github/apache/cordova-ios?branch=master)](https://ci.appveyor.com/project/Humbedooh/cordova-ios)\n[![Build Status](https://travis-ci.org/apache/cordova-ios.svg?branch=master)](https://travis-ci.org/apache/cordova-ios)\n[![codecov.io](https://codecov.io/github/apache/cordova-ios/coverage.svg?branch=master)](https://codecov.io/github/apache/cordova-ios?branch=master)\n\nCordova iOS\n=============================================================\nCordova iOS is an iOS application library that allows for Cordova-based projects to be built for the iOS Platform. Cordova based applications are, at the core, applications written with web technology: HTML, CSS and JavaScript.\n\n<a href=\"http://cordova.apache.org\">Apache Cordova</a> is a project of <a href=\"http://apache.org\">The Apache Software Foundation (ASF)</a>.\n\nRequires:\n\n* Xcode 9.x (deprecated), 10, or greater. Download it at [http://developer.apple.com/downloads](http://developer.apple.com/downloads) or the [Mac App Store](http://itunes.apple.com/us/app/xcode/id497799835?mt=12).\n* [node.js](https://nodejs.org)\n\nCreate a Cordova project\n-------------------------------------------------------------\n\nFollow the instructions in the [**Command-Line Usage** section](http://cordova.apache.org/docs/en/edge/guide_cli_index.md.html#The%20Command-line%20Interface) of [http://docs.cordova.io](http://docs.cordova.io)\n\nTo use a **shared CordovaLib**, for example in development, link the appropriate cordova-ios platform folder path:\n\n    cordova platform add --link /path/to/cordova-ios\n\nUpdating a Cordova project\n-------------------------------------------------------------\n\nWhen you install a new cordova-cli version that comes with a new iOS platform version, from within your project:\n\n    cordova platform rm ios\n    cordova platform add ios\n\nTests\n--------------------------------------------------------------------\n\n1. Run `npm install`\n2. Run `npm test`\n\nFuther reading\n-----\n* [http://cordova.apache.org/](http://cordova.apache.org/)\n* [http://wiki.apache.org/cordova/](http://wiki.apache.org/cordova/)\n",
+  "readmeFilename": "README.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/apache/cordova-ios.git"

km0App/node_modules/cordova-plugin-android-permissions/LICENSE

+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

km0App/node_modules/cordova-plugin-android-permissions/README.md

+Android permission Cordova plugin
+========
+
+This plugin is designed for supporting Android new permissions checking mechanism.
+
+Since Android 6.0, the Android permissions checking mechanism has been changed. In the past, the permissions were granted by users when they decide to install the app. Now, the permissions should be granted by a user when he/she is using the app.
+
+For old Android plugins you (developers) are using may not support this new mechanism or already stop updating. So either to find a new plugin to solving this problem, nor trying to add the mechanism in the old plugin. If you don't want to do those, you can try this plugin.
+
+As a convenience we support browser and iOS platforms as well. But this plugin will simple reply that any permission checked of requested was granted.
+
+Installation
+--------
+
+```bash
+cordova plugin add cordova-plugin-android-permissions
+```
+
+※ Support Android SDK >= 14
+
+Usage
+--------
+
+### API
+
+```javascript
+var permissions = cordova.plugins.permissions;
+permissions.checkPermission(permission, successCallback, errorCallback);
+permissions.requestPermission(permission, successCallback, errorCallback);
+permissions.requestPermissions(permissions, successCallback, errorCallback);
+```
+
+#### Deprecated API - still work now, will not support in the future.
+```javascript
+permissions.hasPermission(permission, successCallback, errorCallback);
+permissions.hasPermission(successCallback, errorCallback, permission);
+permissions.requestPermission(successCallback, errorCallback, permission);
+```
+
+### Permission Name
+
+Following the Android design. See [Manifest.permission](http://developer.android.com/intl/zh-tw/reference/android/Manifest.permission.html).
+```javascript
+// Example
+permissions.ACCESS_COARSE_LOCATION
+permissions.CAMERA
+permissions.GET_ACCOUNTS
+permissions.READ_CONTACTS
+permissions.READ_CALENDAR
+...
+```
+
+## Examples
+```js
+var permissions = cordova.plugins.permissions;
+```
+
+#### Quick check
+```js
+
+permissions.hasPermission(permissions.CAMERA, function( status ){
+  if ( status.hasPermission ) {
+    console.log("Yes :D ");
+  }
+  else {
+    console.warn("No :( ");
+  }
+});
+```
+#### Quick request
+```js
+permissions.requestPermission(permissions.CAMERA, success, error);
+
+function error() {
+  console.warn('Camera permission is not turned on');
+}
+
+function success( status ) {
+  if( !status.hasPermission ) error();
+}
+```
+#### Example multiple permissions
+```js
+var list = [
+  permissions.CAMERA,
+  permissions.GET_ACCOUNTS
+];
+
+permissions.hasPermission(list, callback, null);
+
+function error() {
+  console.warn('Camera or Accounts permission is not turned on');
+}
+
+function success( status ) {
+  if( !status.hasPermission ) {
+  
+    permissions.requestPermissions(
+      list,
+      function(status) {
+        if( !status.hasPermission ) error();
+      },
+      error);
+  }
+}
+```
+
+License
+--------
+
+    Copyright (C) 2016 Jason Yang
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.

km0App/node_modules/cordova-plugin-android-permissions/package.json

+{
+  "_args": [
+    [
+      "cordova-plugin-android-permissions",
+      "/home/manodg/Documents/kilometro0/km0App"
+    ]
+  ],
+  "_from": "cordova-plugin-android-permissions@latest",
+  "_hasShrinkwrap": false,
+  "_id": "cordova-plugin-android-permissions@1.0.2",
+  "_inCache": true,
+  "_installable": true,
+  "_location": "/cordova-plugin-android-permissions",
+  "_nodeVersion": "10.16.2",
+  "_npmOperationalInternal": {
+    "host": "s3://npm-registry-packages",
+    "tmp": "tmp/cordova-plugin-android-permissions_1.0.2_1571061856339_0.05585259418496635"
+  },
+  "_npmUser": {
+    "email": "jason760924@gmail.com",
+    "name": "jasonyang"
+  },
+  "_npmVersion": "6.9.0",
+  "_phantomChildren": {},
+  "_requested": {
+    "name": "cordova-plugin-android-permissions",
+    "raw": "cordova-plugin-android-permissions",
+    "rawSpec": "",
+    "scope": null,
+    "spec": "latest",
+    "type": "tag"
+  },
+  "_requiredBy": [
+    "/"
+  ],
+  "_resolved": "https://registry.npmjs.org/cordova-plugin-android-permissions/-/cordova-plugin-android-permissions-1.0.2.tgz",
+  "_shasum": "e26556ff11a560dffa33a5915d27fe9d44b3c248",
+  "_shrinkwrap": null,
+  "_spec": "cordova-plugin-android-permissions",
+  "_where": "/home/manodg/Documents/kilometro0/km0App",
+  "author": {
+    "name": "Jason Yang"
+  },
+  "bugs": {
+    "url": "https://github.com/NeoLSN/cordova-plugin-android-permission/issues"
+  },
+  "cordova": {
+    "id": "cordova-plugin-android-permissions",
+    "platforms": [
+      "android",
+      "browser",
+      "ios"
+    ]
+  },
+  "dependencies": {},
+  "description": "Android 6.0 permissions check.",
+  "devDependencies": {},
+  "directories": {},
+  "dist": {
+    "fileCount": 7,
+    "integrity": "sha512-Eb7Cf3lk9RydSYqmUzBAEVTT/EU+opV2yvyqkgZZAB/RVfHxsla/1wzHq0PBwAFjHIrxBAGZrOpJFVKc1SxtuA==",
+    "npm-signature": "-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJdpIBgCRA9TVsSAnZWagAABDkP/1JqmQ3OLZD718d/BOc9\nFLncYZVoAy3EN8lrdRT0dVWI7/mAe+a2mOUKShNLQZy3ZSX0miP5VzdfR7Qo\nF+80L4LDryY8/3yWcK+ihfUMT5S6B431tCIc4u4+m2rmFPvz+yGuBOhg0Mri\nkPDFslXqW+JM51AuBO9t9C9OYccAwy49NU5A9K3RAnXaso+o7M75cjtHDUdU\n/FEc7PSBo7DJiBYLbp5JTNw08Vx1e7qYyMtfK2WzOSMuT96htBzs71WnBGb0\nQbOzPdG4XHvSq4bnF/vffhfM4A+b5qNa2WAIhfUGOj6lYJqTIO7gpd/3Zsa3\niwBYr6WMky7ILuw3obPneDheIBSnsZyus2x45SzpmnCltsoUAEYf4YXGDaM4\nQTxs52nxzHKHf/3LKqM2SruGu5lcwcZzQg9Ly21SjdGtuHsvm1O2PBsxmd7e\nV4BA/Rd5cz3KWNoh+uvwZTzxMeS1wb9CxGlhEueqqQFkI0E0VDDG1x5jHSlt\n7bf9xsaENQLiiFwVwtV0WRFphat/SnJ2Rt7bUeudGzrB0ZYNW3g0gSrwax2s\nhmtTm4GTCaxafQX3ReyTxVrIRGqLGtXNqOuW+V4T3ZSJqovzNbfj4hWrs7EU\nDaizpMEQFjmZuRzvZX7fwe23mX4mF9om+u4o1RkR+ZKoc2GL1e9UtK1T4NBY\nssj5\r\n=dvxe\r\n-----END PGP SIGNATURE-----\r\n",
+    "shasum": "e26556ff11a560dffa33a5915d27fe9d44b3c248",
+    "tarball": "https://registry.npmjs.org/cordova-plugin-android-permissions/-/cordova-plugin-android-permissions-1.0.2.tgz",
+    "unpackedSize": 47488
+  },
+  "engines": [
+    {
+      "name": "cordova",
+      "version": ">=5.0.0"
+    }
+  ],
+  "gitHead": "43ababbc419f5ede0846236d341c93cc6f4efe4e",
+  "homepage": "https://github.com/NeoLSN/cordova-plugin-android-permission#readme",
+  "keywords": [
+    "cordova-android",
+    "cordova-browser",
+    "cordova-ios",
+    "ecosystem:cordova"
+  ],
+  "license": "Apache 2.0",
+  "maintainers": [
+    {
+      "name": "jasonyang",
+      "email": "jason760924@gmail.com"
+    }
+  ],
+  "name": "cordova-plugin-android-permissions",
+  "optionalDependencies": {},
+  "readme": "ERROR: No README data found!",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeoLSN/cordova-plugin-android-permission.git"
+  },
+  "version": "1.0.2"
+}

km0App/node_modules/cordova-plugin-android-permissions/plugin.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+        xmlns:android="http://schemas.android.com/apk/res/android"
+        id="cordova-plugin-android-permissions"
+        version="1.0.2">
+
+  <name>Permissions</name>
+
+  <description>Android permissions support library.</description>
+
+  <author>Jason Yang</author>
+
+  <engines>
+    <engine name="cordova" version=">=5.0.0"/>
+  </engines>
+
+  <!-- android -->
+  <platform name="android">
+    <js-module src="www/permissions.js" name="Permissions">
+      <clobbers target="cordova.plugins.permissions" />
+    </js-module>
+
+    <config-file target="res/xml/config.xml" parent="/*">
+      <feature name="Permissions">
+        <param name="android-package" value="com.android.plugins.Permissions" />
+      </feature>
+    </config-file>
+
+    <source-file src="src/android/com/android/plugins/Permissions.java" target-dir="src/com/android/plugins"/>
+  </platform>
+
+  <!-- browser -->
+  <platform name="browser">
+    <js-module src="www/permissions-dummy.js" name="Permissions">
+      <clobbers target="cordova.plugins.permissions" />
+    </js-module>
+  </platform>
+
+  <!-- ios -->
+  <platform name="ios">
+    <js-module src="www/permissions-dummy.js" name="Permissions">
+      <clobbers target="cordova.plugins.permissions" />
+    </js-module>
+  </platform>
+
+</plugin>

km0App/node_modules/cordova-plugin-android-permissions/src/android/com/android/plugins/Permissions.java

+package com.android.plugins;
+
+import android.os.Build;
+
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaPlugin;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+/**
+ * Created by JasonYang on 2016/3/11.
+ */
+public class Permissions extends CordovaPlugin {
+
+    private static final String ACTION_CHECK_PERMISSION = "checkPermission";
+    private static final String ACTION_REQUEST_PERMISSION = "requestPermission";
+    private static final String ACTION_REQUEST_PERMISSIONS = "requestPermissions";
+
+    private static final int REQUEST_CODE_ENABLE_PERMISSION = 55433;
+
+    private static final String KEY_ERROR = "error";
+    private static final String KEY_MESSAGE = "message";
+    private static final String KEY_RESULT_PERMISSION = "hasPermission";
+
+    private CallbackContext permissionsCallback;
+
+    @Override
+    public boolean execute(String action, final JSONArray args, final CallbackContext callbackContext) throws JSONException {
+        if (ACTION_CHECK_PERMISSION.equals(action)) {
+            cordova.getThreadPool().execute(new Runnable() {
+                public void run() {
+                    checkPermissionAction(callbackContext, args);
+                }
+            });
+            return true;
+        } else if (ACTION_REQUEST_PERMISSION.equals(action) || ACTION_REQUEST_PERMISSIONS.equals(action)) {
+            cordova.getThreadPool().execute(new Runnable() {
+                public void run() {
+                    try {
+                        requestPermissionAction(callbackContext, args);
+                    } catch (Exception e) {
+                        e.printStackTrace();
+                        JSONObject returnObj = new JSONObject();
+                        addProperty(returnObj, KEY_ERROR, ACTION_REQUEST_PERMISSION);
+                        addProperty(returnObj, KEY_MESSAGE, "Request permission has been denied.");
+                        callbackContext.error(returnObj);
+                        permissionsCallback = null;
+                    }
+                }
+            });
+            return true;
+        }
+        return false;
+    }
+
+    @Override
+    public void onRequestPermissionResult(int requestCode, String[] permissions, int[] grantResults) throws JSONException {
+        if (permissionsCallback == null) {
+            return;
+        }
+
+        JSONObject returnObj = new JSONObject();
+        if (permissions != null && permissions.length > 0) {
+            //Call checkPermission again to verify
+            boolean hasAllPermissions = hasAllPermissions(permissions);
+            addProperty(returnObj, KEY_RESULT_PERMISSION, hasAllPermissions);
+            permissionsCallback.success(returnObj);
+        } else {
+            addProperty(returnObj, KEY_ERROR, ACTION_REQUEST_PERMISSION);
+            addProperty(returnObj, KEY_MESSAGE, "Unknown error.");
+            permissionsCallback.error(returnObj);
+        }
+        permissionsCallback = null;
+    }
+
+    private void checkPermissionAction(CallbackContext callbackContext, JSONArray permission) {
+        if (permission == null || permission.length() == 0 || permission.length() > 1) {
+            JSONObject returnObj = new JSONObject();
+            addProperty(returnObj, KEY_ERROR, ACTION_CHECK_PERMISSION);
+            addProperty(returnObj, KEY_MESSAGE, "One time one permission only.");
+            callbackContext.error(returnObj);
+        } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            JSONObject returnObj = new JSONObject();
+            addProperty(returnObj, KEY_RESULT_PERMISSION, true);
+            callbackContext.success(returnObj);
+        } else {
+            try {
+                JSONObject returnObj = new JSONObject();
+                addProperty(returnObj, KEY_RESULT_PERMISSION, cordova.hasPermission(permission.getString(0)));
+                callbackContext.success(returnObj);
+            } catch (JSONException e) {
+                e.printStackTrace();
+            }
+        }
+    }
+
+    private void requestPermissionAction(CallbackContext callbackContext, JSONArray permissions) throws Exception {
+        if (permissions == null || permissions.length() == 0) {
+            JSONObject returnObj = new JSONObject();
+            addProperty(returnObj, KEY_ERROR, ACTION_REQUEST_PERMISSION);
+            addProperty(returnObj, KEY_MESSAGE, "At least one permission.");
+            callbackContext.error(returnObj);
+        } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            JSONObject returnObj = new JSONObject();
+            addProperty(returnObj, KEY_RESULT_PERMISSION, true);
+            callbackContext.success(returnObj);
+        } else if (hasAllPermissions(permissions)) {
+            JSONObject returnObj = new JSONObject();
+            addProperty(returnObj, KEY_RESULT_PERMISSION, true);
+            callbackContext.success(returnObj);
+        } else {
+            permissionsCallback = callbackContext;
+            String[] permissionArray = getPermissions(permissions);
+            cordova.requestPermissions(this, REQUEST_CODE_ENABLE_PERMISSION, permissionArray);
+        }
+    }
+
+    private String[] getPermissions(JSONArray permissions) {
+        String[] stringArray = new String[permissions.length()];
+        for (int i = 0; i < permissions.length(); i++) {
+            try {
+                stringArray[i] = permissions.getString(i);
+            } catch (JSONException ignored) {
+                //Believe exception only occurs when adding duplicate keys, so just ignore it
+            }
+        }
+        return stringArray;
+    }
+
+    private boolean hasAllPermissions(JSONArray permissions) throws JSONException {
+        return hasAllPermissions(getPermissions(permissions));
+    }
+
+    private boolean hasAllPermissions(String[] permissions) throws JSONException {
+
+        for (String permission : permissions) {
+            if(!cordova.hasPermission(permission)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    private void addProperty(JSONObject obj, String key, Object value) {
+        try {
+            if (value == null) {
+                obj.put(key, JSONObject.NULL);
+            } else {
+                obj.put(key, value);
+            }
+        } catch (JSONException ignored) {
+            //Believe exception only occurs when adding duplicate keys, so just ignore it
+        }
+    }
+}

km0App/node_modules/cordova-plugin-android-permissions/www/permissions-dummy.js

+var permissionsName = 'Permissions';
+
+function Permissions() {
+
+    this.ACCESS_CHECKIN_PROPERTIES = 'android.permission.ACCESS_CHECKIN_PROPERTIES';
+    this.ACCESS_COARSE_LOCATION = 'android.permission.ACCESS_COARSE_LOCATION';
+    this.ACCESS_FINE_LOCATION = 'android.permission.ACCESS_FINE_LOCATION';
+    this.ACCESS_LOCATION_EXTRA_COMMANDS = 'android.permission.ACCESS_LOCATION_EXTRA_COMMANDS';
+    this.ACCESS_MOCK_LOCATION = 'android.permission.ACCESS_MOCK_LOCATION';
+    this.ACCESS_NETWORK_STATE = 'android.permission.ACCESS_NETWORK_STATE';
+    this.ACCESS_SURFACE_FLINGER = 'android.permission.ACCESS_SURFACE_FLINGER';
+    this.ACCESS_WIFI_STATE = 'android.permission.ACCESS_WIFI_STATE';
+    this.ACCOUNT_MANAGER = 'android.permission.ACCOUNT_MANAGER';
+    this.ADD_VOICEMAIL = 'com.android.voicemail.permission.ADD_VOICEMAIL';
+    this.AUTHENTICATE_ACCOUNTS = 'android.permission.AUTHENTICATE_ACCOUNTS';
+    this.BATTERY_STATS = 'android.permission.BATTERY_STATS';
+    this.BIND_ACCESSIBILITY_SERVICE = 'android.permission.BIND_ACCESSIBILITY_SERVICE';
+    this.BIND_APPWIDGET = 'android.permission.BIND_APPWIDGET';
+    this.BIND_CARRIER_MESSAGING_SERVICE = 'android.permission.BIND_CARRIER_MESSAGING_SERVICE';
+    this.BIND_DEVICE_ADMIN = 'android.permission.BIND_DEVICE_ADMIN';
+    this.BIND_DREAM_SERVICE = 'android.permission.BIND_DREAM_SERVICE';
+    this.BIND_INPUT_METHOD = 'android.permission.BIND_INPUT_METHOD';
+    this.BIND_NFC_SERVICE = 'android.permission.BIND_NFC_SERVICE';
+    this.BIND_NOTIFICATION_LISTENER_SERVICE = 'android.permission.BIND_NOTIFICATION_LISTENER_SERVICE';
+    this.BIND_PRINT_SERVICE = 'android.permission.BIND_PRINT_SERVICE';
+    this.BIND_REMOTEVIEWS = 'android.permission.BIND_REMOTEVIEWS';
+    this.BIND_TEXT_SERVICE = 'android.permission.BIND_TEXT_SERVICE';
+    this.BIND_TV_INPUT = 'android.permission.BIND_TV_INPUT';
+    this.BIND_VOICE_INTERACTION = 'android.permission.BIND_VOICE_INTERACTION';
+    this.BIND_VPN_SERVICE = 'android.permission.BIND_VPN_SERVICE';
+    this.BIND_WALLPAPER = 'android.permission.BIND_WALLPAPER';
+    this.BLUETOOTH = 'android.permission.BLUETOOTH';
+    this.BLUETOOTH_ADMIN = 'android.permission.BLUETOOTH_ADMIN';
+    this.BLUETOOTH_PRIVILEGED = 'android.permission.BLUETOOTH_PRIVILEGED';
+    this.BODY_SENSORS = 'android.permission.BODY_SENSORS';
+    this.BRICK = 'android.permission.BRICK';
+    this.BROADCAST_PACKAGE_REMOVED = 'android.permission.BROADCAST_PACKAGE_REMOVED';
+    this.BROADCAST_SMS = 'android.permission.BROADCAST_SMS';
+    this.BROADCAST_STICKY = 'android.permission.BROADCAST_STICKY';
+    this.BROADCAST_WAP_PUSH = 'android.permission.BROADCAST_WAP_PUSH';
+    this.CALL_PHONE = 'android.permission.CALL_PHONE';
+    this.CALL_PRIVILEGED = 'android.permission.CALL_PRIVILEGED';
+    this.CAMERA = 'android.permission.CAMERA';
+    this.CAPTURE_AUDIO_OUTPUT = 'android.permission.CAPTURE_AUDIO_OUTPUT';
+    this.CAPTURE_SECURE_VIDEO_OUTPUT = 'android.permission.CAPTURE_SECURE_VIDEO_OUTPUT';
+    this.CAPTURE_VIDEO_OUTPUT = 'android.permission.CAPTURE_VIDEO_OUTPUT';
+    this.CHANGE_COMPONENT_ENABLED_STATE = 'android.permission.CHANGE_COMPONENT_ENABLED_STATE';
+    this.CHANGE_CONFIGURATION = 'android.permission.CHANGE_CONFIGURATION';
+    this.CHANGE_NETWORK_STATE = 'android.permission.CHANGE_NETWORK_STATE';
+    this.CHANGE_WIFI_MULTICAST_STATE = 'android.permission.CHANGE_WIFI_MULTICAST_STATE';
+    this.CHANGE_WIFI_STATE = 'android.permission.CHANGE_WIFI_STATE';
+    this.CLEAR_APP_CACHE = 'android.permission.CLEAR_APP_CACHE';
+    this.CLEAR_APP_USER_DATA = 'android.permission.CLEAR_APP_USER_DATA';
+    this.CONTROL_LOCATION_UPDATES = 'android.permission.CONTROL_LOCATION_UPDATES';
+    this.DELETE_CACHE_FILES = 'android.permission.DELETE_CACHE_FILES';
+    this.DELETE_PACKAGES = 'android.permission.DELETE_PACKAGES';
+    this.DEVICE_POWER = 'android.permission.DEVICE_POWER';
+    this.DIAGNOSTIC = 'android.permission.DIAGNOSTIC';
+    this.DISABLE_KEYGUARD = 'android.permission.DISABLE_KEYGUARD';
+    this.DUMP = 'android.permission.DUMP';
+    this.EXPAND_STATUS_BAR = 'android.permission.EXPAND_STATUS_BAR';
+    this.FACTORY_TEST = 'android.permission.FACTORY_TEST';
+    this.FLASHLIGHT = 'android.permission.FLASHLIGHT';
+    this.FORCE_BACK = 'android.permission.FORCE_BACK';
+    this.GET_ACCOUNTS = 'android.permission.GET_ACCOUNTS';
+    this.GET_PACKAGE_SIZE = 'android.permission.GET_PACKAGE_SIZE';
+    this.GET_TASKS = 'android.permission.GET_TASKS';
+    this.GET_TOP_ACTIVITY_INFO = 'android.permission.GET_TOP_ACTIVITY_INFO';
+    this.GLOBAL_SEARCH = 'android.permission.GLOBAL_SEARCH';
+    this.HARDWARE_TEST = 'android.permission.HARDWARE_TEST';
+    this.INJECT_EVENTS = 'android.permission.INJECT_EVENTS';
+    this.INSTALL_LOCATION_PROVIDER = 'android.permission.INSTALL_LOCATION_PROVIDER';
+    this.INSTALL_PACKAGES = 'android.permission.INSTALL_PACKAGES';
+    this.INSTALL_SHORTCUT = 'com.android.launcher.permission.INSTALL_SHORTCUT';
+    this.INTERNAL_SYSTEM_WINDOW = 'android.permission.INTERNAL_SYSTEM_WINDOW';
+    this.INTERNET = 'android.permission.INTERNET';
+    this.KILL_BACKGROUND_PROCESSES = 'android.permission.KILL_BACKGROUND_PROCESSES';
+    this.LOCATION_HARDWARE = 'android.permission.LOCATION_HARDWARE';
+    this.MANAGE_ACCOUNTS = 'android.permission.MANAGE_ACCOUNTS';
+    this.MANAGE_APP_TOKENS = 'android.permission.MANAGE_APP_TOKENS';
+    this.MANAGE_DOCUMENTS = 'android.permission.MANAGE_DOCUMENTS';
+    this.MASTER_CLEAR = 'android.permission.MASTER_CLEAR';
+    this.MEDIA_CONTENT_CONTROL = 'android.permission.MEDIA_CONTENT_CONTROL';
+    this.MODIFY_AUDIO_SETTINGS = 'android.permission.MODIFY_AUDIO_SETTINGS';
+    this.MODIFY_PHONE_STATE = 'android.permission.MODIFY_PHONE_STATE';
+    this.MOUNT_FORMAT_FILESYSTEMS = 'android.permission.MOUNT_FORMAT_FILESYSTEMS';
+    this.MOUNT_UNMOUNT_FILESYSTEMS = 'android.permission.MOUNT_UNMOUNT_FILESYSTEMS';
+    this.NFC = 'android.permission.NFC';
+    this.PERSISTENT_ACTIVITY = 'android.permission.PERSISTENT_ACTIVITY';
+    this.PROCESS_OUTGOING_CALLS = 'android.permission.PROCESS_OUTGOING_CALLS';
+    this.READ_CALENDAR = 'android.permission.READ_CALENDAR';
+    this.READ_CALL_LOG = 'android.permission.READ_CALL_LOG';
+    this.READ_CONTACTS = 'android.permission.READ_CONTACTS';
+    this.READ_EXTERNAL_STORAGE = 'android.permission.READ_EXTERNAL_STORAGE';
+    this.READ_FRAME_BUFFER = 'android.permission.READ_FRAME_BUFFER';
+    this.READ_HISTORY_BOOKMARKS = 'com.android.browser.permission.READ_HISTORY_BOOKMARKS';
+    this.READ_INPUT_STATE = 'android.permission.READ_INPUT_STATE';
+    this.READ_LOGS = 'android.permission.READ_LOGS';
+    this.READ_PHONE_STATE = 'android.permission.READ_PHONE_STATE';
+    this.READ_PROFILE = 'android.permission.READ_PROFILE';
+    this.READ_SMS = 'android.permission.READ_SMS';
+    this.READ_SOCIAL_STREAM = 'android.permission.READ_SOCIAL_STREAM';
+    this.READ_SYNC_SETTINGS = 'android.permission.READ_SYNC_SETTINGS';
+    this.READ_SYNC_STATS = 'android.permission.READ_SYNC_STATS';
+    this.READ_USER_DICTIONARY = 'android.permission.READ_USER_DICTIONARY';
+    this.READ_VOICEMAIL = 'com.android.voicemail.permission.READ_VOICEMAIL';
+    this.REBOOT = 'android.permission.REBOOT';
+    this.RECEIVE_BOOT_COMPLETED = 'android.permission.RECEIVE_BOOT_COMPLETED';
+    this.RECEIVE_MMS = 'android.permission.RECEIVE_MMS';
+    this.RECEIVE_SMS = 'android.permission.RECEIVE_SMS';
+    this.RECEIVE_WAP_PUSH = 'android.permission.RECEIVE_WAP_PUSH';
+    this.RECORD_AUDIO = 'android.permission.RECORD_AUDIO';
+    this.REORDER_TASKS = 'android.permission.REORDER_TASKS';
+    this.RESTART_PACKAGES = 'android.permission.RESTART_PACKAGES';
+    this.SEND_RESPOND_VIA_MESSAGE = 'android.permission.SEND_RESPOND_VIA_MESSAGE';
+    this.SEND_SMS = 'android.permission.SEND_SMS';
+    this.SET_ACTIVITY_WATCHER = 'android.permission.SET_ACTIVITY_WATCHER';
+    this.SET_ALARM = 'com.android.alarm.permission.SET_ALARM';
+    this.SET_ALWAYS_FINISH = 'android.permission.SET_ALWAYS_FINISH';
+    this.SET_ANIMATION_SCALE = 'android.permission.SET_ANIMATION_SCALE';
+    this.SET_DEBUG_APP = 'android.permission.SET_DEBUG_APP';
+    this.SET_ORIENTATION = 'android.permission.SET_ORIENTATION';
+    this.SET_POINTER_SPEED = 'android.permission.SET_POINTER_SPEED';
+    this.SET_PREFERRED_APPLICATIONS = 'android.permission.SET_PREFERRED_APPLICATIONS';
+    this.SET_PROCESS_LIMIT = 'android.permission.SET_PROCESS_LIMIT';
+    this.SET_TIME = 'android.permission.SET_TIME';
+    this.SET_TIME_ZONE = 'android.permission.SET_TIME_ZONE';
+    this.SET_WALLPAPER = 'android.permission.SET_WALLPAPER';
+    this.SET_WALLPAPER_HINTS = 'android.permission.SET_WALLPAPER_HINTS';
+    this.SIGNAL_PERSISTENT_PROCESSES = 'android.permission.SIGNAL_PERSISTENT_PROCESSES';
+    this.STATUS_BAR = 'android.permission.STATUS_BAR';
+    this.SUBSCRIBED_FEEDS_READ = 'android.permission.SUBSCRIBED_FEEDS_READ';
+    this.SUBSCRIBED_FEEDS_WRITE = 'android.permission.SUBSCRIBED_FEEDS_WRITE';
+    this.SYSTEM_ALERT_WINDOW = 'android.permission.SYSTEM_ALERT_WINDOW';
+    this.TRANSMIT_IR = 'android.permission.TRANSMIT_IR';
+    this.UNINSTALL_SHORTCUT = 'com.android.launcher.permission.UNINSTALL_SHORTCUT';
+    this.UPDATE_DEVICE_STATS = 'android.permission.UPDATE_DEVICE_STATS';
+    this.USE_CREDENTIALS = 'android.permission.USE_CREDENTIALS';
+    this.USE_SIP = 'android.permission.USE_SIP';
+    this.VIBRATE = 'android.permission.VIBRATE';
+    this.WAKE_LOCK = 'android.permission.WAKE_LOCK';
+    this.WRITE_APN_SETTINGS = 'android.permission.WRITE_APN_SETTINGS';
+    this.WRITE_CALENDAR = 'android.permission.WRITE_CALENDAR';
+    this.WRITE_CALL_LOG = 'android.permission.WRITE_CALL_LOG';
+    this.WRITE_CONTACTS = 'android.permission.WRITE_CONTACTS';
+    this.WRITE_EXTERNAL_STORAGE = 'android.permission.WRITE_EXTERNAL_STORAGE';
+    this.WRITE_GSERVICES = 'android.permission.WRITE_GSERVICES';
+    this.WRITE_HISTORY_BOOKMARKS = 'com.android.browser.permission.WRITE_HISTORY_BOOKMARKS';
+    this.WRITE_PROFILE = 'android.permission.WRITE_PROFILE';
+    this.WRITE_SECURE_SETTINGS = 'android.permission.WRITE_SECURE_SETTINGS';
+    this.WRITE_SETTINGS = 'android.permission.WRITE_SETTINGS';
+    this.WRITE_SMS = 'android.permission.WRITE_SMS';
+    this.WRITE_SOCIAL_STREAM = 'android.permission.WRITE_SOCIAL_STREAM';
+    this.WRITE_SYNC_SETTINGS = 'android.permission.WRITE_SYNC_SETTINGS';
+    this.WRITE_USER_DICTIONARY = 'android.permission.WRITE_USER_DICTIONARY';
+    this.WRITE_VOICEMAIL = 'com.android.voicemail.permission.WRITE_VOICEMAIL';
+}
+
+function deprecated(name) {
+  console.warn("Calling cordova.plugins.permissions." + name + " with the successCallback as first argument is deprecated");
+  console.warn("The new signature is '" + name + "(permission, successCallback, errorCallback)'");
+}
+
+Permissions.prototype = {
+    checkPermission: function(permission, successCallback, errorCallback) {
+        successCallback( {hasPermission: true} );
+    },
+    requestPermission: function(permission, successCallback, errorCallback) {
+        if (typeof permission === "function") {
+            deprecated("requestPermission");
+            successCallback = arguments[0];
+            errorCallback = arguments[1];
+            permission = arguments[2];
+        }
+        successCallback( {hasPermission: true} );
+    },
+    requestPermissions: function(permissions, successCallback, errorCallback) {
+        successCallback( {hasPermission: true} );
+    }
+};
+
+Permissions.prototype.hasPermission = function (permission, successCallback, errorCallback) {
+    console.warn("hasPermission() function deprecated. Considers using checkPermission()");
+
+    if (typeof permission === "function") {
+        deprecated("hasPermission");
+        successCallback = arguments[0];
+        errorCallback = arguments[1];
+        permission = arguments[2];
+    }
+    this.checkPermission.call(this, permission, successCallback, errorCallback);
+};
+
+module.exports = new Permissions();

km0App/node_modules/cordova-plugin-android-permissions/www/permissions.js

+var permissionsName = 'Permissions';
+
+function Permissions() {
+
+    this.ACCESS_CHECKIN_PROPERTIES = 'android.permission.ACCESS_CHECKIN_PROPERTIES';
+    this.ACCESS_COARSE_LOCATION = 'android.permission.ACCESS_COARSE_LOCATION';
+    this.ACCESS_FINE_LOCATION = 'android.permission.ACCESS_FINE_LOCATION';
+    this.ACCESS_LOCATION_EXTRA_COMMANDS = 'android.permission.ACCESS_LOCATION_EXTRA_COMMANDS';
+    this.ACCESS_MOCK_LOCATION = 'android.permission.ACCESS_MOCK_LOCATION';
+    this.ACCESS_NETWORK_STATE = 'android.permission.ACCESS_NETWORK_STATE';
+    this.ACCESS_SURFACE_FLINGER = 'android.permission.ACCESS_SURFACE_FLINGER';
+    this.ACCESS_WIFI_STATE = 'android.permission.ACCESS_WIFI_STATE';
+    this.ACCOUNT_MANAGER = 'android.permission.ACCOUNT_MANAGER';
+    this.ADD_VOICEMAIL = 'com.android.voicemail.permission.ADD_VOICEMAIL';
+    this.AUTHENTICATE_ACCOUNTS = 'android.permission.AUTHENTICATE_ACCOUNTS';
+    this.BATTERY_STATS = 'android.permission.BATTERY_STATS';
+    this.BIND_ACCESSIBILITY_SERVICE = 'android.permission.BIND_ACCESSIBILITY_SERVICE';
+    this.BIND_APPWIDGET = 'android.permission.BIND_APPWIDGET';
+    this.BIND_CARRIER_MESSAGING_SERVICE = 'android.permission.BIND_CARRIER_MESSAGING_SERVICE';
+    this.BIND_DEVICE_ADMIN = 'android.permission.BIND_DEVICE_ADMIN';
+    this.BIND_DREAM_SERVICE = 'android.permission.BIND_DREAM_SERVICE';
+    this.BIND_INPUT_METHOD = 'android.permission.BIND_INPUT_METHOD';
+    this.BIND_NFC_SERVICE = 'android.permission.BIND_NFC_SERVICE';
+    this.BIND_NOTIFICATION_LISTENER_SERVICE = 'android.permission.BIND_NOTIFICATION_LISTENER_SERVICE';
+    this.BIND_PRINT_SERVICE = 'android.permission.BIND_PRINT_SERVICE';
+    this.BIND_REMOTEVIEWS = 'android.permission.BIND_REMOTEVIEWS';
+    this.BIND_TEXT_SERVICE = 'android.permission.BIND_TEXT_SERVICE';
+    this.BIND_TV_INPUT = 'android.permission.BIND_TV_INPUT';
+    this.BIND_VOICE_INTERACTION = 'android.permission.BIND_VOICE_INTERACTION';
+    this.BIND_VPN_SERVICE = 'android.permission.BIND_VPN_SERVICE';
+    this.BIND_WALLPAPER = 'android.permission.BIND_WALLPAPER';
+    this.BLUETOOTH = 'android.permission.BLUETOOTH';
+    this.BLUETOOTH_ADMIN = 'android.permission.BLUETOOTH_ADMIN';
+    this.BLUETOOTH_PRIVILEGED = 'android.permission.BLUETOOTH_PRIVILEGED';
+    this.BODY_SENSORS = 'android.permission.BODY_SENSORS';
+    this.BRICK = 'android.permission.BRICK';
+    this.BROADCAST_PACKAGE_REMOVED = 'android.permission.BROADCAST_PACKAGE_REMOVED';
+    this.BROADCAST_SMS = 'android.permission.BROADCAST_SMS';
+    this.BROADCAST_STICKY = 'android.permission.BROADCAST_STICKY';
+    this.BROADCAST_WAP_PUSH = 'android.permission.BROADCAST_WAP_PUSH';
+    this.CALL_PHONE = 'android.permission.CALL_PHONE';
+    this.CALL_PRIVILEGED = 'android.permission.CALL_PRIVILEGED';
+    this.CAMERA = 'android.permission.CAMERA';
+    this.CAPTURE_AUDIO_OUTPUT = 'android.permission.CAPTURE_AUDIO_OUTPUT';
+    this.CAPTURE_SECURE_VIDEO_OUTPUT = 'android.permission.CAPTURE_SECURE_VIDEO_OUTPUT';
+    this.CAPTURE_VIDEO_OUTPUT = 'android.permission.CAPTURE_VIDEO_OUTPUT';
+    this.CHANGE_COMPONENT_ENABLED_STATE = 'android.permission.CHANGE_COMPONENT_ENABLED_STATE';
+    this.CHANGE_CONFIGURATION = 'android.permission.CHANGE_CONFIGURATION';
+    this.CHANGE_NETWORK_STATE = 'android.permission.CHANGE_NETWORK_STATE';
+    this.CHANGE_WIFI_MULTICAST_STATE = 'android.permission.CHANGE_WIFI_MULTICAST_STATE';
+    this.CHANGE_WIFI_STATE = 'android.permission.CHANGE_WIFI_STATE';
+    this.CLEAR_APP_CACHE = 'android.permission.CLEAR_APP_CACHE';
+    this.CLEAR_APP_USER_DATA = 'android.permission.CLEAR_APP_USER_DATA';
+    this.CONTROL_LOCATION_UPDATES = 'android.permission.CONTROL_LOCATION_UPDATES';
+    this.DELETE_CACHE_FILES = 'android.permission.DELETE_CACHE_FILES';
+    this.DELETE_PACKAGES = 'android.permission.DELETE_PACKAGES';
+    this.DEVICE_POWER = 'android.permission.DEVICE_POWER';
+    this.DIAGNOSTIC = 'android.permission.DIAGNOSTIC';
+    this.DISABLE_KEYGUARD = 'android.permission.DISABLE_KEYGUARD';
+    this.DUMP = 'android.permission.DUMP';
+    this.EXPAND_STATUS_BAR = 'android.permission.EXPAND_STATUS_BAR';
+    this.FACTORY_TEST = 'android.permission.FACTORY_TEST';
+    this.FLASHLIGHT = 'android.permission.FLASHLIGHT';
+    this.FORCE_BACK = 'android.permission.FORCE_BACK';
+    this.GET_ACCOUNTS = 'android.permission.GET_ACCOUNTS';
+    this.GET_PACKAGE_SIZE = 'android.permission.GET_PACKAGE_SIZE';
+    this.GET_TASKS = 'android.permission.GET_TASKS';
+    this.GET_TOP_ACTIVITY_INFO = 'android.permission.GET_TOP_ACTIVITY_INFO';
+    this.GLOBAL_SEARCH = 'android.permission.GLOBAL_SEARCH';
+    this.HARDWARE_TEST = 'android.permission.HARDWARE_TEST';
+    this.INJECT_EVENTS = 'android.permission.INJECT_EVENTS';
+    this.INSTALL_LOCATION_PROVIDER = 'android.permission.INSTALL_LOCATION_PROVIDER';
+    this.INSTALL_PACKAGES = 'android.permission.INSTALL_PACKAGES';
+    this.INSTALL_SHORTCUT = 'com.android.launcher.permission.INSTALL_SHORTCUT';
+    this.INTERNAL_SYSTEM_WINDOW = 'android.permission.INTERNAL_SYSTEM_WINDOW';
+    this.INTERNET = 'android.permission.INTERNET';
+    this.KILL_BACKGROUND_PROCESSES = 'android.permission.KILL_BACKGROUND_PROCESSES';
+    this.LOCATION_HARDWARE = 'android.permission.LOCATION_HARDWARE';
+    this.MANAGE_ACCOUNTS = 'android.permission.MANAGE_ACCOUNTS';
+    this.MANAGE_APP_TOKENS = 'android.permission.MANAGE_APP_TOKENS';
+    this.MANAGE_DOCUMENTS = 'android.permission.MANAGE_DOCUMENTS';
+    this.MASTER_CLEAR = 'android.permission.MASTER_CLEAR';
+    this.MEDIA_CONTENT_CONTROL = 'android.permission.MEDIA_CONTENT_CONTROL';
+    this.MODIFY_AUDIO_SETTINGS = 'android.permission.MODIFY_AUDIO_SETTINGS';
+    this.MODIFY_PHONE_STATE = 'android.permission.MODIFY_PHONE_STATE';
+    this.MOUNT_FORMAT_FILESYSTEMS = 'android.permission.MOUNT_FORMAT_FILESYSTEMS';
+    this.MOUNT_UNMOUNT_FILESYSTEMS = 'android.permission.MOUNT_UNMOUNT_FILESYSTEMS';
+    this.NFC = 'android.permission.NFC';
+    this.PERSISTENT_ACTIVITY = 'android.permission.PERSISTENT_ACTIVITY';
+    this.PROCESS_OUTGOING_CALLS = 'android.permission.PROCESS_OUTGOING_CALLS';
+    this.READ_CALENDAR = 'android.permission.READ_CALENDAR';
+    this.READ_CALL_LOG = 'android.permission.READ_CALL_LOG';
+    this.READ_CONTACTS = 'android.permission.READ_CONTACTS';
+    this.READ_EXTERNAL_STORAGE = 'android.permission.READ_EXTERNAL_STORAGE';
+    this.READ_FRAME_BUFFER = 'android.permission.READ_FRAME_BUFFER';
+    this.READ_HISTORY_BOOKMARKS = 'com.android.browser.permission.READ_HISTORY_BOOKMARKS';
+    this.READ_INPUT_STATE = 'android.permission.READ_INPUT_STATE';
+    this.READ_LOGS = 'android.permission.READ_LOGS';
+    this.READ_PHONE_STATE = 'android.permission.READ_PHONE_STATE';
+    this.READ_PROFILE = 'android.permission.READ_PROFILE';
+    this.READ_SMS = 'android.permission.READ_SMS';
+    this.READ_SOCIAL_STREAM = 'android.permission.READ_SOCIAL_STREAM';
+    this.READ_SYNC_SETTINGS = 'android.permission.READ_SYNC_SETTINGS';
+    this.READ_SYNC_STATS = 'android.permission.READ_SYNC_STATS';
+    this.READ_USER_DICTIONARY = 'android.permission.READ_USER_DICTIONARY';
+    this.READ_VOICEMAIL = 'com.android.voicemail.permission.READ_VOICEMAIL';
+    this.REBOOT = 'android.permission.REBOOT';
+    this.RECEIVE_BOOT_COMPLETED = 'android.permission.RECEIVE_BOOT_COMPLETED';
+    this.RECEIVE_MMS = 'android.permission.RECEIVE_MMS';
+    this.RECEIVE_SMS = 'android.permission.RECEIVE_SMS';
+    this.RECEIVE_WAP_PUSH = 'android.permission.RECEIVE_WAP_PUSH';
+    this.RECORD_AUDIO = 'android.permission.RECORD_AUDIO';
+    this.REORDER_TASKS = 'android.permission.REORDER_TASKS';
+    this.RESTART_PACKAGES = 'android.permission.RESTART_PACKAGES';
+    this.SEND_RESPOND_VIA_MESSAGE = 'android.permission.SEND_RESPOND_VIA_MESSAGE';
+    this.SEND_SMS = 'android.permission.SEND_SMS';
+    this.SET_ACTIVITY_WATCHER = 'android.permission.SET_ACTIVITY_WATCHER';
+    this.SET_ALARM = 'com.android.alarm.permission.SET_ALARM';
+    this.SET_ALWAYS_FINISH = 'android.permission.SET_ALWAYS_FINISH';
+    this.SET_ANIMATION_SCALE = 'android.permission.SET_ANIMATION_SCALE';
+    this.SET_DEBUG_APP = 'android.permission.SET_DEBUG_APP';
+    this.SET_ORIENTATION = 'android.permission.SET_ORIENTATION';
+    this.SET_POINTER_SPEED = 'android.permission.SET_POINTER_SPEED';
+    this.SET_PREFERRED_APPLICATIONS = 'android.permission.SET_PREFERRED_APPLICATIONS';
+    this.SET_PROCESS_LIMIT = 'android.permission.SET_PROCESS_LIMIT';
+    this.SET_TIME = 'android.permission.SET_TIME';
+    this.SET_TIME_ZONE = 'android.permission.SET_TIME_ZONE';
+    this.SET_WALLPAPER = 'android.permission.SET_WALLPAPER';
+    this.SET_WALLPAPER_HINTS = 'android.permission.SET_WALLPAPER_HINTS';
+    this.SIGNAL_PERSISTENT_PROCESSES = 'android.permission.SIGNAL_PERSISTENT_PROCESSES';
+    this.STATUS_BAR = 'android.permission.STATUS_BAR';
+    this.SUBSCRIBED_FEEDS_READ = 'android.permission.SUBSCRIBED_FEEDS_READ';
+    this.SUBSCRIBED_FEEDS_WRITE = 'android.permission.SUBSCRIBED_FEEDS_WRITE';
+    this.SYSTEM_ALERT_WINDOW = 'android.permission.SYSTEM_ALERT_WINDOW';
+    this.TRANSMIT_IR = 'android.permission.TRANSMIT_IR';
+    this.UNINSTALL_SHORTCUT = 'com.android.launcher.permission.UNINSTALL_SHORTCUT';
+    this.UPDATE_DEVICE_STATS = 'android.permission.UPDATE_DEVICE_STATS';
+    this.USE_CREDENTIALS = 'android.permission.USE_CREDENTIALS';
+    this.USE_SIP = 'android.permission.USE_SIP';
+    this.VIBRATE = 'android.permission.VIBRATE';
+    this.WAKE_LOCK = 'android.permission.WAKE_LOCK';
+    this.WRITE_APN_SETTINGS = 'android.permission.WRITE_APN_SETTINGS';
+    this.WRITE_CALENDAR = 'android.permission.WRITE_CALENDAR';
+    this.WRITE_CALL_LOG = 'android.permission.WRITE_CALL_LOG';
+    this.WRITE_CONTACTS = 'android.permission.WRITE_CONTACTS';
+    this.WRITE_EXTERNAL_STORAGE = 'android.permission.WRITE_EXTERNAL_STORAGE';
+    this.WRITE_GSERVICES = 'android.permission.WRITE_GSERVICES';
+    this.WRITE_HISTORY_BOOKMARKS = 'com.android.browser.permission.WRITE_HISTORY_BOOKMARKS';
+    this.WRITE_PROFILE = 'android.permission.WRITE_PROFILE';
+    this.WRITE_SECURE_SETTINGS = 'android.permission.WRITE_SECURE_SETTINGS';
+    this.WRITE_SETTINGS = 'android.permission.WRITE_SETTINGS';
+    this.WRITE_SMS = 'android.permission.WRITE_SMS';
+    this.WRITE_SOCIAL_STREAM = 'android.permission.WRITE_SOCIAL_STREAM';
+    this.WRITE_SYNC_SETTINGS = 'android.permission.WRITE_SYNC_SETTINGS';
+    this.WRITE_USER_DICTIONARY = 'android.permission.WRITE_USER_DICTIONARY';
+    this.WRITE_VOICEMAIL = 'com.android.voicemail.permission.WRITE_VOICEMAIL';
+}
+
+function deprecated(name) {
+  console.warn("Calling cordova.plugins.permissions." + name + " with the successCallback as first argument is deprecated");
+  console.warn("The new signature is '" + name + "(permission, successCallback, errorCallback)'");
+}
+
+Permissions.prototype = {
+    checkPermission: function(permission, successCallback, errorCallback) {
+        cordova.exec(successCallback, errorCallback, permissionsName, 'checkPermission', [permission]);
+    },
+    requestPermission: function(permission, successCallback, errorCallback) {
+        if (typeof permission === "function") {
+            deprecated("requestPermission");
+            successCallback = arguments[0];
+            errorCallback = arguments[1];
+            permission = arguments[2];
+        }
+        cordova.exec(successCallback, errorCallback, permissionsName, 'requestPermission', [permission]);
+    },
+    requestPermissions: function(permissions, successCallback, errorCallback) {
+        cordova.exec(successCallback, errorCallback, permissionsName, 'requestPermissions', permissions);
+    }
+};
+
+Permissions.prototype.hasPermission = function (permission, successCallback, errorCallback) {
+    console.warn("hasPermission() function deprecated. Considers using checkPermission()");
+
+    if (typeof permission === "function") {
+        deprecated("hasPermission");
+        successCallback = arguments[0];
+        errorCallback = arguments[1];
+        permission = arguments[2];
+    }
+    this.checkPermission.call(this, permission, successCallback, errorCallback);
+};
+
+module.exports = new Permissions();

km0App/node_modules/cordova-plugin-contacts-phonenumbers/README.md

+# ContactsPhoneNumbers
+Cross-platform plugin for Cordova / PhoneGap to list all the contacts with at least a phone number.
+
+## Installing the plugin ##
+```
+cordova plugin add cordova-plugin-contacts-phonenumbers
+```
+or use this repository (unstable)
+```
+cordova plugin add https://github.com/dbaq/cordova-plugin-contacts-phone-numbers.git
+```
+## Using the plugin ##
+The plugin creates the object `navigator.contactsPhoneNumbers` with the methods
+
+  `list(success, fail)`
+
+A full example could be:
+
+```
+   //
+   //
+   // after deviceready
+   //
+   //
+   navigator.contactsPhoneNumbers.list(function(contacts) {
+      console.log(contacts.length + ' contacts found');
+      for(var i = 0; i < contacts.length; i++) {
+         console.log(contacts[i].id + " - " + contacts[i].displayName);
+         for(var j = 0; j < contacts[i].phoneNumbers.length; j++) {
+            var phone = contacts[i].phoneNumbers[j];
+            console.log("===> " + phone.type + "  " + phone.number + " (" + phone.normalizedNumber+ ")");
+         }
+      }
+   }, function(error) {
+      console.error(error);
+   });
+
+```
+
+## JSON Response format
+
+The success callback function contains an array of contacts.
+
+Each entry contains:
+
+   * the unique contact id
+   * the name of the contact (first name, last name, display name)
+   * an array containing the number, the normalizedNumber and the type of the number (```WORK```, ```MOBILE```, ```HOME``` or ```OTHER```)
+
+Here is a sample of what you can get:
+
+```
+    [{
+        "id": "1",
+        "firstName": "Kate",
+        "middleName": "",
+        "lastName": "Bell",
+        "displayName": "Kate Bell",
+        "thumbnail": null,
+        "phoneNumbers": [{
+            "number": "(555) 564-8583",
+            "normalizedNumber": "(555) 564-8583",
+            "type": "MOBILE"
+        }, {
+            "number": "(415) 555-3695",
+            "normalizedNumber": "(415) 555-3695",
+            "type": "OTHER"
+        }]
+    }, {
+        "id": "2",
+        "firstName": "Daniel",
+        "middleName": "",
+        "lastName": "Higgins",
+        "displayName": "Daniel Higgins",
+        "thumbnail": null,
+        "phoneNumbers": [{
+            "number": "555-478-7672",
+            "normalizedNumber": "555-478-7672",
+            "type": "HOME"
+        }, {
+            "number": "(408) 555-5270",
+            "normalizedNumber": "(408) 555-5270",
+            "type": "MOBILE"
+        }, {
+            "number": "(408) 555-3514",
+            "normalizedNumber": "(408) 555-3514",
+            "type": "OTHER"
+        }]
+    }, {
+        "id": "3",
+        "firstName": "John",
+        "middleName": "Paul",
+        "lastName": "Appleseed",
+        "displayName": "John Paul Appleseed",
+        "thumbnail": "content://com.android.contacts/contacts/49/photo",
+        "phoneNumbers": [{
+            "number": "888-555-5512",
+            "normalizedNumber": "888-555-5512",
+            "type": "MOBILE"
+        }, {
+            "number": "888-555-1212",
+            "normalizedNumber": "888-555-1212",
+            "type": "HOME"
+        }]
+    }]
+```
+
+## Behaviour
+
+The plugin retrieves **ONLY** the contacts containing one or more phone numbers. It does not allow to modify them (use [the official cordova contacts plugin for that](https://github.com/apache/cordova-plugin-contacts)).
+
+With the official plugin, it is difficult and inefficient[1] to retrieve the list of all the contacts with at least a phone number (for Android at least). I needed a fastest way to retrieve a simple list containing just the name and the list of phone numbers.
+
+If you need more fields like the email address or if you also need to retrieve the contacts without email address, we can add an option, open an issue and I'll see what I can do.
+
+**[1]** When I say *difficult and inefficient*, it is because on Android, all your Gmail contacts are returned as a contact. [See this issue on stackoverflow](http://stackoverflow.com/questions/20406564/phonegap-contacts-api-android-return-only-phone-contacts-and-not-gmail-conta). With the official plugin you have to retrieve all the contacts and then iterate over the result to filter out what you want.
+
+I executed a small benchmark on my Nexus 5 with Lollipop. The code calls both plugins and displays the result in the console. On this phone I have 1028 contacts but only 71 contacts have at least a phone number. Of course the performances depends on the number of contacts with phone numbers.
+
+**cordova-plugin-contacts**
+
+    *  1 call:
+        try 1: 2.527s
+        try 2: 2.581s
+        try 3: 2.221s
+
+        => average of 2.443s
+
+    * 10 calls:
+        try 1: 6.048s
+        try 2: 9.196s
+        try 3: 8.981s
+
+        => average of 8.075s for 10 calls
+
+**cordova-plugin-contacts-phone-numbers**
+
+    *  1 call
+        try 1: 0.145s
+        try 2: 0.185s
+        try 3: 0.286s
+
+        => average of 0.205s
+
+    * 10 calls:
+        try 1: 1.195s
+        try 2: 1.211s
+        try 3: 1.351s
+
+        => average of 1.252s for 10 calls
+
+## iOS and Android
+
+The plugin works with iOS and Android.
+
+iOS does not provide a normalized number like Android. So number === normalizedNumber for iOS.
+
+The thumbnail is not returned on iOS, if you want iOS support, feel free to open a PR.
+
+The Android code is heavily inspired from the official plugin with some tweaks to improve the perfomances.
+
+## Donations
+
+If your app is successful or if you are working for a company, please consider donating some beer money :beer::
+
+[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.me/dbaq/10)
+
+Keep in mind that I am maintaining this repository on my free time so thank you for considering a donation. :+1:
+
+## Contributing
+
+Thanks for considering contributing to this project.
+
+### Finding something to do
+
+Ask, or pick an issue and comment on it announcing your desire to work on it. Ideally wait until we assign it to you to minimize work duplication.
+
+### Reporting an issue
+
+- Search existing issues before raising a new one.
+
+- Include as much detail as possible.
+
+### Pull requests
+
+- Make it clear in the issue tracker what you are working on, so that someone else doesn't duplicate the work.
+
+- Use a feature branch, not master.
+
+- Rebase your feature branch onto origin/master before raising the PR.
+
+- Keep up to date with changes in master so your PR is easy to merge.
+
+- Be descriptive in your PR message: what is it for, why is it needed, etc.
+
+- Make sure the tests pass
+
+- Squash related commits as much as possible.
+
+### Coding style
+
+- Try to match the existing indent style.
+
+- Don't mix platform-specific stuff into the main code.
+
+
+
+## Licence ##
+
+The MIT License
+
+Copyright (c) 2013 Didier Baquier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

km0App/node_modules/cordova-plugin-contacts-phonenumbers/package.json

+{
+  "_args": [
+    [
+      "cordova-plugin-contacts-phonenumbers",
+      "/home/manodg/Documents/kilometro0/km0App"
+    ]
+  ],
+  "_from": "cordova-plugin-contacts-phonenumbers@latest",
+  "_hasShrinkwrap": false,
+  "_id": "cordova-plugin-contacts-phonenumbers@0.0.12",
+  "_inCache": true,
+  "_installable": true,
+  "_location": "/cordova-plugin-contacts-phonenumbers",
+  "_nodeVersion": "11.1.0",
+  "_npmOperationalInternal": {
+    "host": "s3://npm-registry-packages",
+    "tmp": "tmp/cordova-plugin-contacts-phonenumbers_0.0.12_1551108529626_0.7774231082117682"
+  },
+  "_npmUser": {
+    "email": "didier.baquier@gmail.com",
+    "name": "dbaq"
+  },
+  "_npmVersion": "6.4.1",
+  "_phantomChildren": {},
+  "_requested": {
+    "name": "cordova-plugin-contacts-phonenumbers",
+    "raw": "cordova-plugin-contacts-phonenumbers",
+    "rawSpec": "",
+    "scope": null,
+    "spec": "latest",
+    "type": "tag"
+  },
+  "_requiredBy": [
+    "/"
+  ],
+  "_resolved": "https://registry.npmjs.org/cordova-plugin-contacts-phonenumbers/-/cordova-plugin-contacts-phonenumbers-0.0.12.tgz",
+  "_shasum": "c37220257d11abe0b9a86bc18785bbaa21e27d69",
+  "_shrinkwrap": null,
+  "_spec": "cordova-plugin-contacts-phonenumbers",
+  "_where": "/home/manodg/Documents/kilometro0/km0App",
+  "author": {
+    "name": "Didier Baquier"
+  },
+  "bugs": {
+    "url": "https://github.com/dbaq/cordova-plugin-contacts-phone-numbers/issues"
+  },
+  "cordova": {
+    "id": "cordova-plugin-contacts-phonenumbers",
+    "platforms": [
+      "android",
+      "ios"
+    ]
+  },
+  "dependencies": {},
+  "description": "Cordova Plugin to List Contacts Phone Numbers ",
+  "devDependencies": {},
+  "directories": {},
+  "dist": {
+    "fileCount": 8,
+    "integrity": "sha512-nE9hrJnhpVXXTWAlAi/6MWSxY1Amm1InRfkiOLXazAKFm9HjkVqT80zefjB0Y/KgFolpLsRZn5wS745tTotXPA==",
+    "npm-signature": "-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJcdAmyCRA9TVsSAnZWagAAmEUQAJTJTe6RaQwqPmzp2W4n\nO7/LTTJoaQ3k+yHWfx3KzWIZhKvJz3+vBdxs5J2c193l0HEQYNf0iPWHY/GG\nGwmuV9coT68lAYvaxN8dQmFn66cWZW+hYQlzYlNn5tq37aMBrAtwvaYGKOrV\nCXKHAVBO8OOr4CSW5Kv7RM7Xz9+ll7gTG4gaApcGoB4THn8nwdqaTpOe8f2Q\nYzVEC4rGGKNfzxzNfcDH0TrHYLlFm/yOyXlfrbKXBFVl6V/doq+UGbw3ra5B\ns22ovVBT9B+gVrJ0JKJR2YwJCj847Y7G1vNwpXJXCR+tkiHGl5Ea3HvjA5BB\nGYvgKjZLBb/YeAizkyRUWCL/W5/c89L5h74o4TSd3VclDG9b1+U3DB6F/A8N\nCu/JJ6yryiWjzD4R4xIA0b2BYnQ8b9BnVQfU/B7z2hswVcYkai9omBHuDvOd\n7qhwDRq26vvSpSPukL7+eG5C2feNOcIGoDGHCFhQe9onhjJsjWKNgnQvMwe+\nbMgkU6Q/Pdd0eNNgaRjA+Qd41HjPx0cbQGkdr9nPvAoFlKxjq9JJs7bEbSoV\nLBcn6c7jbdt//gXLgxIkTWEn8ya2FURg37xSSm5KyMJAAd9ZFbkVflVK4/pA\nPj0MNtvNjp2LU0kGRiAAUW4dou3lXQhyB2qHFAi9btfhJ8xPTaMd5mOVXImk\nT1X0\r\n=2q3B\r\n-----END PGP SIGNATURE-----\r\n",
+    "shasum": "c37220257d11abe0b9a86bc18785bbaa21e27d69",
+    "tarball": "https://registry.npmjs.org/cordova-plugin-contacts-phonenumbers/-/cordova-plugin-contacts-phonenumbers-0.0.12.tgz",
+    "unpackedSize": 32642
+  },
+  "gitHead": "989abe18852bcf5854d4fe05ae77b0e8b902aaac",
+  "homepage": "https://github.com/dbaq/cordova-plugin-contacts-phone-numbers#readme",
+  "keywords": [
+    "contacts",
+    "cordova",
+    "cordova-android",
+    "cordova-ios",
+    "ecosystem:cordova",
+    "list",
+    "numbers",
+    "phone"
+  ],
+  "license": "Apache 2.0",
+  "maintainers": [
+    {
+      "name": "dbaq",
+      "email": "didier.baquier@gmail.com"
+    }
+  ],
+  "name": "cordova-plugin-contacts-phonenumbers",
+  "optionalDependencies": {},
+  "readme": "ERROR: No README data found!",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dbaq/cordova-plugin-contacts-phone-numbers.git"
+  },
+  "version": "0.0.12"
+}

km0App/node_modules/cordova-plugin-contacts-phonenumbers/plugin.xml

+<?xml version="1.0" encoding="UTF-8"?>
+
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    id="cordova-plugin-contacts-phonenumbers"
+    version="0.0.12">
+
+    <name>Contacts Phone Numbers</name>
+    <description>Cordova Plugin to List Contacts Phone Numbers </description>
+    <license>Apache 2.0</license>
+    <keywords>cordova,contacts,list,phone,numbers</keywords>
+    <issue>https://github.com/dbaq/cordova-plugin-contacts-phone-numbers/issues</issue>
+
+    <js-module src="www/contactsPhoneNumbers.js" name="contactsPhoneNumbers">
+        <clobbers target="navigator.contactsPhoneNumbers" />
+    </js-module>
+
+    <!-- android -->
+    <platform name="android">
+        <config-file target="res/xml/config.xml" parent="/*">
+            <feature name="ContactsPhoneNumbers">
+                <param name="android-package" value="com.dbaq.cordova.contactsPhoneNumbers.ContactsManager"/>
+            </feature>
+        </config-file>
+
+        <config-file target="AndroidManifest.xml" parent="/*">
+            <uses-permission android:name="android.permission.READ_CONTACTS" />
+        </config-file>
+
+        <source-file src="src/android/ContactsManager.java" target-dir="src/com/dbaq/cordova/contactsPhoneNumbers" />
+    </platform>
+
+    <!-- ios -->
+    <platform name="ios">
+        <config-file target="config.xml" parent="/*">
+            <feature name="ContactsPhoneNumbers">
+                <param name="ios-package" value="CDVContactsPhoneNumbers"/>
+            </feature>
+        </config-file>
+
+        <header-file src="src/ios/CDVContactsPhoneNumbers.h" />
+        <source-file src="src/ios/CDVContactsPhoneNumbers.m" />
+
+        <framework src="AddressBook.framework" weak="true" />
+        <framework src="AddressBookUI.framework" weak="true" />
+        <framework src="CoreGraphics.framework" />
+
+        <preference name="CONTACTS_USAGE_DESCRIPTION" default="This app needs contacts access"/>
+        <config-file target="*-Info.plist" parent="NSContactsUsageDescription">
+            <string>$CONTACTS_USAGE_DESCRIPTION</string>
+        </config-file>
+    </platform>
+</plugin>

km0App/node_modules/cordova-plugin-contacts-phonenumbers/src/android/ContactsManager.java

+package com.dbaq.cordova.contactsPhoneNumbers;
+
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import android.app.Activity;
+import android.content.pm.PackageManager;
+import android.content.ContentResolver;
+import android.content.Intent;
+import android.database.Cursor;
+import android.provider.ContactsContract;
+import android.provider.ContactsContract.CommonDataKinds.Phone;
+import android.provider.ContactsContract.CommonDataKinds.StructuredName;
+import android.provider.ContactsContract.Contacts;
+import android.provider.ContactsContract.Contacts.Data;
+import android.util.Log;
+import static android.Manifest.permission.READ_CONTACTS;
+
+public class ContactsManager extends CordovaPlugin {
+
+    private CallbackContext callbackContext;
+
+    private JSONArray executeArgs;
+
+    private static final int READ_CONTACTS_REQ_CODE = 0;
+
+    public static final String ACTION_LIST_CONTACTS = "list";
+
+    private static final String LOG_TAG = "Contact Phone Numbers";
+
+    public ContactsManager() {}
+
+    /**
+     * Executes the request and returns PluginResult.
+     *
+     * @param action            The action to execute.
+     * @param args              JSONArray of arguments for the plugin.
+     * @param callbackContext   The callback context used when calling back into JavaScript.
+     * @return                  True if the action was valid, false otherwise.
+     */
+    public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+
+        this.callbackContext = callbackContext;
+        this.executeArgs = args;
+
+        if (ACTION_LIST_CONTACTS.equals(action)) {
+            if (cordova.hasPermission(android.Manifest.permission.READ_CONTACTS)) {
+                execHelper();
+            } else {
+                cordova.requestPermission(this, READ_CONTACTS_REQ_CODE, android.Manifest.permission.READ_CONTACTS);
+            }
+            return true;
+        }
+        return false;
+    }
+
+    public void onRequestPermissionResult(int requestCode, String[] permissions, int[] grantResults) throws JSONException {
+        for (int r : grantResults) {
+            if (r == PackageManager.PERMISSION_DENIED) {
+                Log.d(LOG_TAG, "Permission denied");
+                callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR,
+                                                 "User has denied permission"));
+                return;
+            }
+        }
+        execHelper();
+    }
+
+    private void execHelper() {
+        this.cordova.getThreadPool().execute(new Runnable() {
+            public void run() {
+                callbackContext.success(list());
+            }
+        });
+    }
+
+    private JSONArray list() {
+        JSONArray contacts = new JSONArray();
+        ContentResolver cr = this.cordova.getActivity().getContentResolver();
+        String[] projection = new String[] {
+            ContactsContract.Contacts.DISPLAY_NAME,
+            ContactsContract.Contacts.PHOTO_THUMBNAIL_URI,
+            ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME,
+            ContactsContract.CommonDataKinds.StructuredName.MIDDLE_NAME,
+            ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME,
+            ContactsContract.Contacts.HAS_PHONE_NUMBER,
+            ContactsContract.CommonDataKinds.Phone.NUMBER,
+            ContactsContract.CommonDataKinds.Phone.NORMALIZED_NUMBER,
+            ContactsContract.CommonDataKinds.Phone.TYPE,
+            ContactsContract.Data.CONTACT_ID,
+            ContactsContract.Data.MIMETYPE
+        };
+        // Retrieve only the contacts with a phone number at least
+        Cursor cursor = cr.query(ContactsContract.Data.CONTENT_URI,
+                projection,
+                ContactsContract.Contacts.HAS_PHONE_NUMBER + " = 1",
+                null,
+                ContactsContract.Data.CONTACT_ID + " ASC");
+
+        contacts = populateContactArray(cursor);
+        return contacts;
+    }
+
+
+    /**
+     * Creates an array of contacts from the cursor you pass in
+     *
+     * @param c            the cursor
+     * @return             a JSONArray of contacts
+     */
+    private JSONArray populateContactArray(Cursor c) {
+
+        JSONArray contacts = new JSONArray();
+
+        String contactId = null;
+        String oldContactId = null;
+        boolean newContact = true;
+        String mimetype = null;
+
+        JSONObject contact = new JSONObject();
+        JSONArray phones = new JSONArray();
+
+        try {
+            if (c.getCount() > 0) {
+                while (c.moveToNext()) {
+                    contactId = c.getString(c.getColumnIndex(ContactsContract.Data.CONTACT_ID));
+
+                    if (c.getPosition() == 0) // If we are in the first row set the oldContactId
+                        oldContactId = contactId;
+
+                    // When the contact ID changes we need to push the Contact object to the array of contacts and create new objects.
+                    if (!oldContactId.equals(contactId)) {
+                        // Populate the Contact object with it's arrays and push the contact into the contacts array
+                        contact.put("phoneNumbers", phones);
+                        contacts.put(contact);
+                        // Clean up the objects
+                        contact = new JSONObject();
+                        phones = new JSONArray();
+
+                        // Set newContact to true as we are starting to populate a new contact
+                        newContact = true;
+                    }
+
+                    // When we detect a new contact set the ID. These fields are available in every row in the result set returned.
+                    if (newContact) {
+                        newContact = false;
+                        contact.put("id", contactId);
+                    }
+
+                    mimetype = c.getString(c.getColumnIndex(ContactsContract.Data.MIMETYPE)); // Grab the mimetype of the current row as it will be used in a lot of comparisons
+
+                    if (mimetype.equals(ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)) {
+                        contact.put("firstName", c.getString(c.getColumnIndex(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME)));
+                        contact.put("lastName", c.getString(c.getColumnIndex(ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME)));
+                        contact.put("middleName", c.getString(c.getColumnIndex(ContactsContract.CommonDataKinds.StructuredName.MIDDLE_NAME)));
+                        contact.put("displayName", c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME)));
+                        contact.put("thumbnail", c.getString(c.getColumnIndex(ContactsContract.Contacts.PHOTO_THUMBNAIL_URI)));
+                    }
+                    else if (mimetype.equals(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)) {
+                        phones.put(getPhoneNumber(c));
+                    }
+
+                    // Set the old contact ID
+                    oldContactId = contactId;
+                }
+                // Push the last contact into the contacts array
+                contact.put("phoneNumbers", phones);
+                contacts.put(contact);
+            }
+        } catch (JSONException e) {
+            Log.e(LOG_TAG, e.getMessage(), e);
+        }
+        c.close();
+        return contacts;
+    }
+
+    /**
+     * Create a phone number JSONObject
+     * @param cursor the current database row
+     * @return a JSONObject representing a phone number
+     */
+    private JSONObject getPhoneNumber(Cursor cursor) throws JSONException {
+        JSONObject phoneNumber = new JSONObject();
+        String number = cursor.getString(cursor.getColumnIndex(Phone.NUMBER));
+        String normalizedNumber = cursor.getString(cursor.getColumnIndex(Phone.NORMALIZED_NUMBER));
+        phoneNumber.put("number", number);
+        phoneNumber.put("normalizedNumber", (normalizedNumber == null) ? number : normalizedNumber);
+        phoneNumber.put("type", getPhoneTypeLabel(cursor.getInt(cursor.getColumnIndex(Phone.TYPE))));
+        return phoneNumber;
+    }
+
+
+    /**
+     * Retrieve the type of the phone number based on the type code
+     * @param type the code of the type
+     * @return a string in caps representing the type of phone number
+     */
+    private String getPhoneTypeLabel(int type) {
+        String label = "OTHER";
+        if (type == Phone.TYPE_HOME)
+            label = "HOME";
+        else if (type == Phone.TYPE_MOBILE)
+            label = "MOBILE";
+        else if (type == Phone.TYPE_WORK)
+            label = "WORK";
+
+        return label;
+    }
+}

km0App/node_modules/cordova-plugin-contacts-phonenumbers/src/ios/CDVContactsPhoneNumbers.h

+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+
+#import <Foundation/Foundation.h>
+#import <AddressBook/ABAddressBook.h>
+#import <AddressBookUI/AddressBookUI.h>
+#import <Cordova/CDVPlugin.h>
+
+@interface CDVContactsPhoneNumbers : CDVPlugin
+{
+    ABAddressBookRef addressBook;
+}
+
+/*
+ * list
+ *
+ * arguments:
+ *  1: successcallback - this is the javascript function that will be called with the array of found contacts
+ *  2:  errorCallback - optional javascript function to be called in the event of an error
+ */
+- (void)list:(CDVInvokedUrlCommand*)command;
+
+@end
+
+typedef void (^ CDVAddressBookWorkerBlock)(
+    ABAddressBookRef         addrBook
+    );
+@interface CDVAddressBookPhoneNumberHelper : NSObject
+{}
+
+- (void)createAddressBook:(CDVAddressBookWorkerBlock)workerBlock;
+@end

km0App/node_modules/cordova-plugin-contacts-phonenumbers/src/ios/CDVContactsPhoneNumbers.m

+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+
+#import "CDVContactsPhoneNumbers.h"
+#import <UIKit/UIKit.h>
+
+@implementation CDVContactsPhoneNumbers
+
+- (void)list:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+
+    [self.commandDelegate runInBackground:^{
+
+        CDVAddressBookPhoneNumberHelper* abHelper = [[CDVAddressBookPhoneNumberHelper alloc] init];
+        CDVContactsPhoneNumbers* __weak weakSelf = self;
+
+        [abHelper createAddressBook: ^(ABAddressBookRef addrBook) {
+            if (addrBook == NULL) { // permission was denied or other error - return error
+                CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"unauthorized"];
+                [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+                return;
+            }
+
+            NSMutableArray* contactsWithPhoneNumbers = [[NSMutableArray alloc] init];
+
+            CFArrayRef records = ABAddressBookCopyArrayOfAllPeople(addrBook);
+            NSArray *phoneContacts = (__bridge NSArray*)records;
+            CFRelease(records);
+
+            for(int i = 0; i < phoneContacts.count; i++) {
+                ABRecordRef ref = (__bridge ABRecordRef)[phoneContacts objectAtIndex:i];
+
+                ABMultiValueRef phones = ABRecordCopyValue(ref, kABPersonPhoneProperty);
+                int countPhones = ABMultiValueGetCount(phones);
+                //we skip users with no phone numbers
+                if (countPhones > 0) {
+                    NSMutableArray* phoneNumbersArray = [[NSMutableArray alloc] init];
+
+                    for(CFIndex j = 0; j < countPhones; j++) {
+                        CFStringRef phoneNumberRef = ABMultiValueCopyValueAtIndex(phones, j);
+                        CFStringRef phoneTypeLabelRef = ABMultiValueCopyLabelAtIndex(phones, j);
+                        NSString *number = (__bridge NSString *) phoneNumberRef;
+                        NSString *phoneLabel = @"OTHER";
+                        if (phoneTypeLabelRef) {
+                            if (CFEqual(phoneTypeLabelRef, kABWorkLabel)) {
+                                phoneLabel = @"WORK";
+                            } else if (CFEqual(phoneTypeLabelRef, kABHomeLabel)) {
+                                phoneLabel = @"HOME";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhoneMobileLabel)) {
+                                phoneLabel = @"MOBILE";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhoneIPhoneLabel)) {
+                                phoneLabel = @"IPHONE";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhoneMainLabel)) {
+                                phoneLabel = @"MAIN";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhoneHomeFAXLabel)) {
+                                phoneLabel = @"HOMEFAX";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhoneWorkFAXLabel)) {
+                                phoneLabel = @"WORKFAX";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhoneOtherFAXLabel)) {
+                                phoneLabel = @"OTHERFAX";
+                            } else if (CFEqual(phoneTypeLabelRef, kABPersonPhonePagerLabel)) {
+                                phoneLabel = @"PAGER";
+                            }
+                        }
+
+                        // creating the nested element with the phone number details
+                        NSMutableDictionary* phoneNumberDictionary = [NSMutableDictionary dictionaryWithCapacity:1];
+                        [phoneNumberDictionary setObject: number forKey:@"number"];
+                        [phoneNumberDictionary setObject: number forKey:@"normalizedNumber"];
+                        [phoneNumberDictionary setObject: phoneLabel forKey:@"type"];
+                        // adding this phone number to the list of phone numbers for this user
+                        [phoneNumbersArray addObject:phoneNumberDictionary];
+
+                        if (phoneNumberRef) CFRelease(phoneNumberRef);
+                        if (phoneTypeLabelRef) CFRelease(phoneTypeLabelRef);
+                    }
+
+                    // creating the contact object
+                    NSString *displayName;
+
+                    NSString *firstName = (__bridge_transfer NSString*)ABRecordCopyValue(ref, kABPersonFirstNameProperty);
+                    if (!firstName)
+                        firstName = @"";
+                    displayName = firstName;
+
+                    NSString *middleName = (__bridge_transfer NSString*)ABRecordCopyValue(ref, kABPersonMiddleNameProperty);
+                    if (!middleName) {
+                        middleName = @"";
+                    }
+                    else {
+                        if (displayName.length)
+                            displayName = [displayName stringByAppendingString:@" "];
+                        displayName = [displayName stringByAppendingString:middleName];
+                    }
+
+                    NSString *lastName = (__bridge_transfer NSString*)ABRecordCopyValue(ref, kABPersonLastNameProperty);
+                    if (!lastName) {
+                        lastName = @"";
+                    }
+                    else {
+                        if (displayName.length)
+                            displayName = [displayName stringByAppendingString:@" "];
+                        displayName = [displayName stringByAppendingString:lastName];
+                    }
+
+                    NSString *contactId = [NSString stringWithFormat:@"%d", ABRecordGetRecordID(ref)];
+
+                    //NSLog(@"Name %@ - %@", displayName, contactId);
+
+                    NSMutableDictionary* contactDictionary = [NSMutableDictionary dictionaryWithCapacity:1];
+                    [contactDictionary setObject: contactId forKey:@"id"];
+                    [contactDictionary setObject: displayName forKey:@"displayName"];
+                    [contactDictionary setObject: firstName forKey:@"firstName"];
+                    [contactDictionary setObject: lastName forKey:@"lastName"];
+                    [contactDictionary setObject: middleName forKey:@"middleName"];
+                    [contactDictionary setObject: phoneNumbersArray forKey:@"phoneNumbers"];
+
+                    //add the contact to the list to return
+                    [contactsWithPhoneNumbers addObject:contactDictionary];
+                }
+                CFRelease(phones);
+            }
+
+            CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:contactsWithPhoneNumbers];
+            [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+
+            if (addrBook) {
+                CFRelease(addrBook);
+            }
+        }];
+    }];
+
+    return;
+}
+@end
+
+
+
+@implementation CDVAddressBookPhoneNumberHelper
+
+/**
+ * NOTE: workerBlock is responsible for releasing the addressBook that is passed to it
+ */
+- (void)createAddressBook:(CDVAddressBookWorkerBlock)workerBlock
+{
+    ABAddressBookRef addrBook = ABAddressBookCreateWithOptions(NULL, nil);
+    ABAddressBookRequestAccessWithCompletion(addrBook, ^(bool granted, CFErrorRef error) {
+        // callback can occur in background, address book must be accessed on thread it was created on
+        dispatch_sync(dispatch_get_main_queue(), ^{
+            workerBlock(error || !granted ? NULL : addrBook);
+        });
+    });
+}
+
+@end

km0App/node_modules/cordova-plugin-contacts-phonenumbers/www/ContactsPhoneNumbers.d.ts

+interface Navigator {
+    /** Provides access to the device contacts database. */
+    contactsPhoneNumbers: ContactsPhoneNumbers;
+}
+
+interface ContactsPhoneNumbers {
+    /**
+     * The navigator.contactsPhoneNumbers.list method executes asynchronously, querying the device contacts database
+     * and returning an array of Contact objects. The resulting objects are passed to the onSuccess
+     * callback function specified by the onSuccess parameter.
+     * @param onSuccess Success callback function invoked with the array of Contact objects returned from the database
+     * @param onError Error callback function, invoked when an error occurs.
+     */
+    list(onSuccess: (contacts: Contact[]) => void,
+        onError?: (error: string) => void): void;
+}
+
+interface Contact {
+    /** A globally unique identifier. */
+    id?: string;
+    /** The first name of this Contact. */
+    firstName?: string;
+    /** The last name of this Contact. */
+    lastName?: string;
+    /** The name of this Contact, suitable for display to end users. */
+    displayName?: string;
+    /** An array of all the contact's phone numbers. */
+    phoneNumbers?: ContactPhoneNumber[];
+}
+
+declare var Contact: {
+    /** Constructor of Contact object */
+    new(id?: string,
+        firstName?: string,
+        LastName?: string,
+        displayName?: string,
+        phoneNumbers?: ContactPhoneNumber[]): Contact
+};
+
+/** Contains different kinds of information about a Contact object's phone number. */
+interface ContactPhoneNumber {
+    /** The contact phone number's number. */
+    number?: string;
+    /** The contact phone number's normalized number. */
+    normalizedNumber?: string;
+    /** The contact phone number's type (WORK, MOBILE, HOME or OTHER). */
+    type?: string;
+}
+
+declare var ContactPhoneNumber: {
+    /** Constructor for ContactPhoneNumber object */
+    new (number?: string,
+        normalizedNumber?: string,
+        type?: string): ContactPhoneNumber
+};

km0App/node_modules/cordova-plugin-contacts-phonenumbers/www/contactsPhoneNumbers.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+var argscheck = require('cordova/argscheck'),
+    exec = require('cordova/exec');
+    
+/**
+* Represents a group of Contacts.
+* @constructor
+*/
+var contactsList = {
+    /**
+     * Returns an array of Contacts
+     * @param successCB success callback
+     * @param errorCB error callback
+     * @return array of Contacts 
+     */
+    list:function(successCB, errorCB) {
+        argscheck.checkArgs('fF', 'contactsPhoneNumbers.list', arguments);
+        exec(successCB, errorCB, "ContactsPhoneNumbers", "list", []);
+    }
+};
+
+module.exports = contactsList;

km0App/node_modules/cordova-plugin-contacts/.appveyor.yml

+# appveyor file
+# http://www.appveyor.com/docs/appveyor-yml
+
+max_jobs: 1
+
+shallow_clone: true
+
+init:
+  - git config --global core.autocrlf true
+
+image:
+  - Visual Studio 2017
+
+environment:
+  nodejs_version: "4"
+  matrix:
+    - PLATFORM: windows-10-store
+
+install:
+  - npm cache clean -f
+  - node --version
+  - npm install -g cordova-paramedic@https://github.com/apache/cordova-paramedic.git
+  - npm install -g cordova
+
+build: off
+
+test_script:
+  - cordova-paramedic --config pr\%PLATFORM% --plugin . --justBuild

km0App/node_modules/cordova-plugin-contacts/.github/PULL_REQUEST_TEMPLATE.md

+<!--
+Please make sure the checklist boxes are all checked before submitting the PR. The checklist
+is intended as a quick reference, for complete details please see our Contributor Guidelines:
+
+http://cordova.apache.org/contribute/contribute_guidelines.html
+
+Thanks!
+-->
+
+### Platforms affected
+
+
+### What does this PR do?
+
+
+### What testing has been done on this change?
+
+
+### Checklist
+- [ ] [Reported an issue](http://cordova.apache.org/contribute/issues.html) in the JIRA database
+- [ ] Commit message follows the format: "CB-3232: (android) Fix bug with resolving file paths", where CB-xxxx is the JIRA ID & "android" is the platform affected.
+- [ ] Added automated test coverage as appropriate for this change.

km0App/node_modules/cordova-plugin-contacts/.jshintrc

+{
+    "browser": true
+  , "devel": true
+  , "bitwise": true
+  , "undef": true
+  , "trailing": true
+  , "quotmark": false
+  , "indent": 4
+  , "unused": "vars"
+  , "latedef": "nofunc"
+  , "globals": {
+        "module": false,
+        "exports": false,
+        "require": false,
+        "cordova": true,
+        "ContactFindOptions": true,
+        "ContactError": true,
+        "Contact": true,
+        "ContactName": true,
+        "ContactField": true,
+        "ContactAddress": true,
+        "ContactOrganization": true
+    }
+}

km0App/node_modules/cordova-plugin-contacts/.travis.yml

+sudo: false
+addons:
+  jwt:
+    secure: JMPPMkxcqYQQJTmXXj6VHAdNny+95vTWFzY6tV4wFMydTurAX5Rw4H2qotEQjcPHml/8ifB/x/9wjLYEuZ+ZTD13LFXeu3AEJJUyzwJ7nTd0/WXIEgnSp+jorWkuhgd9Wn9+cW+XC5HsWUtib23/FQOOm6rEWNv9tHsJTJDkBOI=
+env:
+  global:
+  - SAUCE_USERNAME=snay
+  - TRAVIS_NODE_VERSION="4.2"
+matrix:
+  include:
+  - env: PLATFORM=ios-9.3
+    os: osx
+    osx_image: xcode7.3
+    language: node_js
+    node_js: '4.2'
+  - env: PLATFORM=ios-10.0
+    os: osx
+    osx_image: xcode7.3
+    language: node_js
+    node_js: '4.2'
+  - env: PLATFORM=android-4.4
+    os: linux
+    language: android
+    jdk: oraclejdk8
+    android:
+      components:
+      - tools
+  - env: PLATFORM=android-5.1
+    os: linux
+    language: android
+    jdk: oraclejdk8
+    android:
+      components:
+      - tools
+  - env: PLATFORM=android-6.0
+    os: linux
+    language: android
+    jdk: oraclejdk8
+    android:
+      components:
+      - tools
+  - env: PLATFORM=android-7.0
+    os: linux
+    language: android
+    jdk: oraclejdk8
+    android:
+      components:
+      - tools
+before_install:
+- rm -rf ~/.nvm && git clone https://github.com/creationix/nvm.git ~/.nvm && (cd ~/.nvm
+  && git checkout `git describe --abbrev=0 --tags`) && source ~/.nvm/nvm.sh && nvm
+  install $TRAVIS_NODE_VERSION
+- node --version
+- if [[ "$PLATFORM" =~ android ]]; then gradle --version; fi
+- if [[ "$PLATFORM" =~ ios ]]; then npm install -g ios-deploy; fi
+- if [[ "$PLATFORM" =~ android ]]; then echo y | android update sdk -u --filter android-22,android-23,android-24,android-25,android-26;
+  fi
+- git clone https://github.com/apache/cordova-paramedic /tmp/paramedic && pushd /tmp/paramedic
+  && npm install && popd
+- npm install -g cordova
+install:
+- npm install
+script:
+- npm test
+- node /tmp/paramedic/main.js --config pr/$PLATFORM --plugin $(pwd) --shouldUseSauce
+  --buildName travis-plugin-contacts-$TRAVIS_JOB_NUMBER
+

km0App/node_modules/cordova-plugin-contacts/CONTRIBUTING.md

+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+
+# Contributing to Apache Cordova
+
+Anyone can contribute to Cordova. And we need your contributions.
+
+There are multiple ways to contribute: report bugs, improve the docs, and
+contribute code.
+
+For instructions on this, start with the 
+[contribution overview](http://cordova.apache.org/contribute/).
+
+The details are explained there, but the important items are:
+ - Sign and submit an Apache ICLA (Contributor License Agreement).
+ - Have a Jira issue open that corresponds to your contribution.
+ - Run the tests so your patch doesn't break existing functionality.
+
+We look forward to your contributions!

km0App/node_modules/cordova-plugin-contacts/LICENSE

+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

km0App/node_modules/cordova-plugin-contacts/NOTICE

+Apache Cordova
+Copyright 2012 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).
+Microsoft Open Technologies, Inc. (http://msopentech.com/).

km0App/node_modules/cordova-plugin-contacts/README.md

+---
+title: Contacts
+description: Manage the contacts on the device.
+---
+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+|AppVeyor|Travis CI|
+|:-:|:-:|
+|[![Build status](https://ci.appveyor.com/api/projects/status/github/apache/cordova-plugin-contacts?branch=master)](https://ci.appveyor.com/project/ApacheSoftwareFoundation/cordova-plugin-contacts)|[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg?branch=master)](https://travis-ci.org/apache/cordova-plugin-contacts)|
+
+# cordova-plugin-contacts
+
+This plugin defines a global `navigator.contacts` object, which provides access to the device contacts database.
+
+Although the object is attached to the global scoped `navigator`, it is not available until after the `deviceready` event.
+```js
+document.addEventListener("deviceready", onDeviceReady, false);
+function onDeviceReady() {
+console.log(navigator.contacts);
+}
+```
+
+__WARNING__: Collection and use of contact data raises
+important privacy issues.  Your app's privacy policy should discuss
+how the app uses contact data and whether it is shared with any other
+parties.  Contact information is considered sensitive because it
+reveals the people with whom a person communicates.  Therefore, in
+addition to the app's privacy policy, you should strongly consider
+providing a just-in-time notice before the app accesses or uses
+contact data, if the device operating system doesn't do so
+already. That notice should provide the same information noted above,
+as well as obtaining the user's permission (e.g., by presenting
+choices for __OK__ and __No Thanks__).  Note that some app
+marketplaces may require the app to provide a just-in-time notice and
+obtain the user's permission before accessing contact data.  A
+clear and easy-to-understand user experience surrounding the use of
+contact data helps avoid user confusion and perceived misuse of
+contact data.  For more information, please see the [Privacy Guide](http://cordova.apache.org/docs/en/latest/guide/appdev/privacy/index.html).
+
+Report issues with this plugin on the [Apache Cordova issue tracker](https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Contacts%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC)
+
+## Deprecation Notice
+
+This plugin is being deprecated. No more work will be done on this plugin by the Cordova development community. You can continue to use this plugin and it should work as-is in the future but any more arising issues will not be fixed by the Cordova community.
+
+## Installation
+
+This requires cordova 5.0+ ( current stable v1.0.0 )
+
+    cordova plugin add cordova-plugin-contacts
+Older versions of cordova can still install via the __deprecated__ id ( stale v0.2.16 )
+
+    cordova plugin add org.apache.cordova.contacts
+It is also possible to install via repo url directly ( unstable )
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+
+
+### iOS Quirks
+
+Since iOS 10 it's mandatory to provide an usage description in the `info.plist` if trying to access privacy-sensitive data. When the system prompts the user to allow access, this usage description string will displayed as part of the permission dialog box, but if you didn't provide the usage description, the app will crash before showing the dialog. Also, Apple will reject apps that access private data but don't provide an usage description.
+
+ This plugins requires the following usage description:
+
+ * `NSContactsUsageDescription` describes the reason that the app accesses the user's contacts.
+
+ To add this entry into the `info.plist`, you can use the `edit-config` tag in the `config.xml` like this:
+
+```
+<edit-config target="NSContactsUsageDescription" file="*-Info.plist" mode="merge">
+    <string>need contacts access to search friends</string>
+</edit-config>
+```
+
+### Firefox OS Quirks
+
+Create __www/manifest.webapp__ as described in
+[Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest).
+Add relevant permisions.
+There is also a need to change the webapp type to "privileged"  - [Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type).
+__WARNING__: All privileged apps enforce [Content Security Policy](https://developer.mozilla.org/en-US/Apps/CSP) which forbids inline script. Initialize your application in another way.
+
+```json
+"type": "privileged",
+"permissions": {
+	"contacts": {
+		"access": "readwrite",
+		"description": "Describe why there is a need for such permission"
+	}
+}
+```
+### Windows Quirks
+
+**Prior to Windows 10:** Any contacts returned from `find` and `pickContact` methods are readonly, so your application cannot modify them.
+`find` method available only on Windows Phone 8.1 devices.
+
+**Windows 10 and above:** Contacts may be saved and will be saved to app-local contacts storage.  Contacts may also be deleted.
+
+### Windows 8 Quirks
+
+Windows 8 Contacts are readonly. Via the Cordova API Contacts are not queryable/searchable, you should inform the user to pick a contact as a call to contacts.pickContact which will open the 'People' app where the user must choose a contact.
+Any contacts returned are readonly, so your application cannot modify them.
+
+## navigator.contacts
+
+### Methods
+
+- navigator.contacts.create
+- navigator.contacts.find
+- navigator.contacts.pickContact
+
+### Objects
+
+- Contact
+- ContactName
+- ContactField
+- ContactAddress
+- ContactOrganization
+- ContactFindOptions
+- ContactError
+- ContactFieldType
+
+## navigator.contacts.create
+
+The `navigator.contacts.create` method is synchronous, and returns a new `Contact` object.
+
+This method does not retain the Contact object in the device contacts
+database, for which you need to invoke the `Contact.save` method.
+
+### Supported Platforms
+
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+
+### Example
+
+```js
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+```
+
+## navigator.contacts.find
+
+The `navigator.contacts.find` method executes asynchronously, querying the
+device contacts database and returning an array of `Contact` objects.
+The resulting objects are passed to the `contactSuccess` callback
+function specified by the __contactSuccess__ parameter.
+
+The __contactFields__ parameter specifies the fields to be used as a
+search qualifier.  A zero-length __contactFields__ parameter is invalid and results in
+`ContactError.INVALID_ARGUMENT_ERROR`. A __contactFields__ value of
+`"*"` searches all contact fields.
+
+The __contactFindOptions.filter__ string can be used as a search
+filter when querying the contacts database.  If provided, a
+case-insensitive, partial value match is applied to each field
+specified in the __contactFields__ parameter.  If there's a match for
+_any_ of the specified fields, the contact is returned. Use __contactFindOptions.desiredFields__
+parameter to control which contact properties must be returned back.
+
+Supported values for both __contactFields__ and __contactFindOptions.desiredFields__ parameters are enumerated in [`ContactFieldType`](#contactfieldtype) object.
+
+### Parameters
+
+- __contactFields__: Contact fields to use as a search qualifier. _(DOMString[])_ [Required]
+
+- __contactSuccess__: Success callback function invoked with the array of Contact objects returned from the database. [Required]
+
+- __contactError__: Error callback function, invoked when an error occurs. [Optional]
+
+- __contactFindOptions__: Search options to filter navigator.contacts. [Optional]
+
+	Keys include:
+
+	- __filter__: The search string used to find navigator.contacts. _(DOMString)_ (Default: `""`)
+
+	- __multiple__: Determines if the find operation returns multiple navigator.contacts. _(Boolean)_ (Default: `false`)
+
+    - __desiredFields__: Contact fields to be returned back. If specified, the resulting `Contact` object only features values for these fields. _(DOMString[])_ [Optional]
+
+    - __hasPhoneNumber__(Android only): Filters the search to only return contacts with a phone number informed. _(Boolean)_ (Default: `false`)
+
+### Supported Platforms
+
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+- Windows (Windows Phone 8.1 and Windows 10)
+
+### Example
+
+```js
+function onSuccess(contacts) {
+	alert('Found ' + contacts.length + ' contacts.');
+};
+
+function onError(contactError) {
+	alert('onError!');
+};
+
+// find all contacts with 'Bob' in any name field
+var options      = new ContactFindOptions();
+options.filter   = "Bob";
+options.multiple = true;
+options.desiredFields = [navigator.contacts.fieldType.id];
+options.hasPhoneNumber = true;
+var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+navigator.contacts.find(fields, onSuccess, onError, options);
+```
+
+### Windows Quirks
+
+- `__contactFields__` is not supported and will be ignored. `find` method will always attempt to match the name, email address, or phone number of a contact.
+
+## navigator.contacts.pickContact
+
+The `navigator.contacts.pickContact` method launches the Contact Picker to select a single contact.
+The resulting object is passed to the `contactSuccess` callback
+function specified by the __contactSuccess__ parameter.
+
+### Parameters
+
+- __contactSuccess__: Success callback function invoked with the single Contact object. [Required]
+
+- __contactError__: Error callback function, invoked when an error occurs. [Optional]
+
+### Supported Platforms
+
+- Android
+- iOS
+- Windows Phone 8
+- Windows
+
+### Example
+
+```js
+navigator.contacts.pickContact(function(contact){
+        console.log('The following contact has been selected:' + JSON.stringify(contact));
+    },function(err){
+        console.log('Error: ' + err);
+    });
+```
+
+### Android Quirks
+
+This plugin launches an external Activity for picking contacts. See the
+[Android Lifecycle Guide](http://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html#lifecycle-guide)
+for an explanation of how this affects your application. If the plugin returns
+its result in the `resume` event, then you must first wrap the returned object
+in a `Contact` object before using it. Here is an example:
+
+```javascript
+function onResume(resumeEvent) {
+    if(resumeEvent.pendingResult) {
+        if(resumeEvent.pendingResult.pluginStatus === "OK") {
+            var contact = navigator.contacts.create(resumeEvent.pendingResult.result);
+            successCallback(contact);
+        } else {
+            failCallback(resumeEvent.pendingResult.result);
+        }
+    }
+}
+```
+
+## Contact
+
+The `Contact` object represents a user's contact.  Contacts can be
+created, stored, or removed from the device contacts database.
+Contacts can also be retrieved (individually or in bulk) from the
+database by invoking the `navigator.contacts.find` method.
+
+__NOTE__: Not all of the contact fields listed above are supported on
+every device platform.  Please check each platform's _Quirks_ section
+for details.
+
+
+### Properties
+
+- __id__: A globally unique identifier. _(DOMString)_
+
+- __displayName__: The name of this Contact, suitable for display to end users. _(DOMString)_
+
+- __name__: An object containing all components of a persons name. _(ContactName)_
+
+- __nickname__: A casual name by which to address the contact. _(DOMString)_
+
+- __phoneNumbers__: An array of all the contact's phone numbers. _(ContactField[])_
+
+- __emails__: An array of all the contact's email addresses. _(ContactField[])_
+
+- __addresses__: An array of all the contact's addresses. _(ContactAddress[])_
+
+- __ims__: An array of all the contact's IM addresses. _(ContactField[])_
+
+- __organizations__: An array of all the contact's organizations. _(ContactOrganization[])_
+
+- __birthday__: The birthday of the contact. _(Date)_
+
+- __note__: A note about the contact. _(DOMString)_
+
+- __photos__: An array of the contact's photos. _(ContactField[])_
+
+- __categories__:  An array of all the user-defined categories associated with the contact. _(ContactField[])_
+
+- __urls__:  An array of web pages associated with the contact. _(ContactField[])_
+
+### Methods
+
+- __clone__: Returns a new `Contact` object that is a deep copy of the calling object, with the `id` property set to `null`.
+
+- __remove__: Removes the contact from the device contacts database, otherwise executes an error callback with a `ContactError` object.
+
+- __save__: Saves a new contact to the device contacts database, or updates an existing contact if a contact with the same __id__ already exists.
+
+### Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+- Windows
+
+### Save Example
+
+```js
+function onSuccess(contact) {
+    alert("Save Success");
+};
+
+function onError(contactError) {
+    alert("Error = " + contactError.code);
+};
+
+// create a new contact object
+var contact = navigator.contacts.create();
+contact.displayName = "Plumber";
+contact.nickname = "Plumber";            // specify both to support all devices
+
+// populate some fields
+var name = new ContactName();
+name.givenName = "Jane";
+name.familyName = "Doe";
+contact.name = name;
+
+// save to device
+contact.save(onSuccess,onError);
+```
+
+### Clone Example
+
+```js
+// clone the contact object
+var clone = contact.clone();
+clone.name.givenName = "John";
+console.log("Original contact name = " + contact.name.givenName);
+console.log("Cloned contact name = " + clone.name.givenName);
+```
+
+### Remove Example
+
+```js
+function onSuccess() {
+    alert("Removal Success");
+};
+
+function onError(contactError) {
+    alert("Error = " + contactError.code);
+};
+
+// remove the contact from the device
+contact.remove(onSuccess,onError);
+```
+### Removing phone number(s) from a saved contact
+
+```js
+// Example to create a contact with 3 phone numbers and then remove
+// 2 phone numbers. This example is for illustrative purpose only
+var myContact = navigator.contacts.create({"displayName": "Test User"});
+var phoneNumbers = [];
+
+phoneNumbers[0] = new ContactField('work', '768-555-1234', false);
+phoneNumbers[1] = new ContactField('mobile', '999-555-5432', true); // preferred number
+phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+
+myContact.phoneNumbers = phoneNumbers;
+myContact.save(function (contact_obj) {
+    var contactObjToModify = contact_obj.clone();
+    contact_obj.remove(function(){
+        var phoneNumbers = [contactObjToModify.phoneNumbers[0]];
+        contactObjToModify.phoneNumbers = phoneNumbers;
+        contactObjToModify.save(function(c_obj){
+            console.log("All Done");
+        }, function(error){
+            console.log("Not able to save the cloned object: " + error);
+        });
+    }, function(contactError) {
+        console.log("Contact Remove Operation failed: " + contactError);
+    });
+});
+```
+
+### Android 2.X Quirks
+
+- __categories__:  Not supported on Android 2.X devices, returning `null`.
+
+### BlackBerry 10 Quirks
+
+- __id__: Assigned by the device when saving the contact.
+
+### FirefoxOS Quirks
+
+- __categories__: Partially supported. Fields __pref__ and __type__ are returning `null`
+
+- __ims__: Not supported
+
+- __photos__: Not supported
+
+
+### iOS Quirks
+
+- __displayName__: Not supported on iOS, returning `null` unless there is no `ContactName` specified, in which case it returns the composite name, __nickname__ or `""`, respectively.
+
+- __birthday__: Must be input as a JavaScript `Date` object, the same way it is returned.
+
+- __photos__: Returns a File URL to the image, which is stored in the application's temporary directory.  Contents of the temporary directory are removed when the application exits.
+
+- __categories__:  This property is currently not supported, returning `null`.
+
+### Windows Phone 8 Quirks
+
+- __displayName__: When creating a contact, the value provided for the display name parameter differs from the display name retrieved when finding the contact.
+
+- __urls__: When creating a contact, users can input and save more than one web address, but only one is available when searching the contact.
+
+- __phoneNumbers__: The _pref_ option is not supported. The _type_ is not supported in a _find_ operation. Only one `phoneNumber` is allowed for each _type_.
+
+- __emails__: The _pref_ option is not supported. Home and personal references same email entry. Only one entry is allowed for each _type_.
+
+- __addresses__: Supports only work, and home/personal _type_. The home and personal _type_ reference the same address entry. Only one entry is allowed for each _type_.
+
+- __organizations__: Only one is allowed, and does not support the _pref_, _type_, and _department_ attributes.
+
+- __note__: Not supported, returning `null`.
+
+- __ims__: Not supported, returning `null`.
+
+- __birthdays__: Not supported, returning `null`.
+
+- __categories__: Not supported, returning `null`.
+
+- __remove__: Method is not supported
+
+### Windows Quirks
+
+- __photos__: Returns a File URL to the image, which is stored in the application's temporary directory.
+
+- __birthdays__: Not supported, returning `null`.
+
+- __categories__: Not supported, returning `null`.
+
+- __remove__: Method is only supported in Windows 10 or above.
+
+## ContactAddress
+
+The `ContactAddress` object stores the properties of a single address
+of a contact.  A `Contact` object may include more than one address in
+a `ContactAddress[]` array.
+
+
+### Properties
+
+- __pref__: Set to `true` if this `ContactAddress` contains the user's preferred value. _(boolean)_
+
+- __type__: A string indicating what type of field this is, _home_ for example. _(DOMString)_
+
+- __formatted__: The full address formatted for display. _(DOMString)_
+
+- __streetAddress__: The full street address. _(DOMString)_
+
+- __locality__: The city or locality. _(DOMString)_
+
+- __region__: The state or region. _(DOMString)_
+
+- __postalCode__: The zip code or postal code. _(DOMString)_
+
+- __country__: The country name. _(DOMString)_
+
+### Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+- Windows
+
+### Example
+
+```js
+// display the address information for all contacts
+
+function onSuccess(contacts) {
+    for (var i = 0; i < contacts.length; i++) {
+        for (var j = 0; j < contacts[i].addresses.length; j++) {
+            alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                "Country: "        + contacts[i].addresses[j].country);
+        }
+    }
+};
+
+function onError(contactError) {
+    alert('onError!');
+};
+
+// find all contacts
+var options = new ContactFindOptions();
+options.filter = "";
+options.multiple = true;
+var filter = ["displayName", "addresses"];
+navigator.contacts.find(filter, onSuccess, onError, options);
+```
+
+### Android 2.X Quirks
+
+- __pref__: Not supported, returning `false` on Android 2.X devices.
+
+### BlackBerry 10 Quirks
+
+- __pref__: Not supported on BlackBerry devices, returning `false`.
+
+- __type__: Partially supported.  Only one each of _Work_ and _Home_ type addresses can be stored per contact.
+
+- __formatted__: Partially supported.  Returns a concatenation of all BlackBerry address fields.
+
+- __streetAddress__: Supported.  Returns a concatenation of BlackBerry __address1__ and __address2__ address fields.
+
+- __locality__: Supported.  Stored in BlackBerry __city__ address field.
+
+- __region__: Supported.  Stored in BlackBerry __stateProvince__ address field.
+
+- __postalCode__: Supported.  Stored in BlackBerry __zipPostal__ address field.
+
+- __country__: Supported.
+
+### FirefoxOS Quirks
+
+- __formatted__: Currently not supported
+
+### iOS Quirks
+
+- __pref__: Not supported on iOS devices, returning `false`.
+
+- __formatted__: Currently not supported.
+
+### Windows Quirks
+
+- __pref__: Not supported
+
+
+## ContactError
+
+The `ContactError` object is returned to the user through the
+`contactError` callback function when an error occurs.
+
+### Properties
+
+- __code__: One of the predefined error codes listed below.
+
+### Constants
+
+- `ContactError.UNKNOWN_ERROR` (code 0)
+- `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+- `ContactError.TIMEOUT_ERROR` (code 2)
+- `ContactError.PENDING_OPERATION_ERROR` (code 3)
+- `ContactError.IO_ERROR` (code 4)
+- `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+- `ContactError.OPERATION_CANCELLED_ERROR` (code 6)
+- `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+
+## ContactField
+
+The `ContactField` object is a reusable component that represents
+contact fields generically.  Each `ContactField` object contains a
+`value`, `type`, and `pref` property.  A `Contact` object stores
+several properties in `ContactField[]` arrays, such as phone numbers
+and email addresses.
+
+In most instances, there are no pre-determined values for a
+`ContactField` object's __type__ attribute.  For example, a phone
+number can specify __type__ values of _home_, _work_, _mobile_,
+_iPhone_, or any other value that is supported by a particular device
+platform's contact database.  However, for the `Contact` __photos__
+field, the __type__ field indicates the format of the returned image:
+__url__ when the __value__ attribute contains a URL to the photo
+image, or _base64_ when the __value__ contains a base64-encoded image
+string.
+
+### Properties
+
+- __type__: A string that indicates what type of field this is, _home_ for example. _(DOMString)_
+
+- __value__: The value of the field, such as a phone number or email address. _(DOMString)_
+
+- __pref__: Set to `true` if this `ContactField` contains the user's preferred value. _(boolean)_
+
+### Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+- Windows
+
+### Example
+
+```js
+// create a new contact
+var contact = navigator.contacts.create();
+
+// store contact phone numbers in ContactField[]
+var phoneNumbers = [];
+phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+contact.phoneNumbers = phoneNumbers;
+
+// save the contact
+contact.save();
+```
+
+### Android Quirks
+
+- __pref__: Not supported, returning `false`.
+
+### BlackBerry 10 Quirks
+
+- __type__: Partially supported.  Used for phone numbers.
+
+- __value__: Supported.
+
+- __pref__: Not supported, returning `false`.
+
+### iOS Quirks
+
+- __pref__: Not supported, returning `false`.
+
+### Windows Quirks
+
+- __pref__: Not supported, returning `false`.
+
+
+## ContactName
+
+Contains different kinds of information about a `Contact` object's name.
+
+### Properties
+
+- __formatted__: The complete name of the contact. _(DOMString)_
+
+- __familyName__: The contact's family name. _(DOMString)_
+
+- __givenName__: The contact's given name. _(DOMString)_
+
+- __middleName__: The contact's middle name. _(DOMString)_
+
+- __honorificPrefix__: The contact's prefix (example _Mr._ or _Dr._) _(DOMString)_
+
+- __honorificSuffix__: The contact's suffix (example _Esq._). _(DOMString)_
+
+### Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+- Windows
+
+### Example
+
+```js
+function onSuccess(contacts) {
+    for (var i = 0; i < contacts.length; i++) {
+        alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+            "Family Name: "  + contacts[i].name.familyName      + "\n" +
+            "Given Name: "   + contacts[i].name.givenName       + "\n" +
+            "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+            "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+            "Prefix: "       + contacts[i].name.honorificSuffix);
+    }
+};
+
+function onError(contactError) {
+    alert('onError!');
+};
+
+var options = new ContactFindOptions();
+options.filter = "";
+options.multiple = true;
+filter = ["displayName", "name"];
+navigator.contacts.find(filter, onSuccess, onError, options);
+```
+
+### Android Quirks
+
+- __formatted__: Partially supported, and read-only.  Returns a concatenation of `honorificPrefix`, `givenName`, `middleName`, `familyName`, and `honorificSuffix`.
+
+### BlackBerry 10 Quirks
+
+- __formatted__: Partially supported.  Returns a concatenation of BlackBerry __firstName__ and __lastName__ fields.
+
+- __familyName__: Supported.  Stored in BlackBerry __lastName__ field.
+
+- __givenName__: Supported.  Stored in BlackBerry __firstName__ field.
+
+- __middleName__: Not supported, returning `null`.
+
+- __honorificPrefix__: Not supported, returning `null`.
+
+- __honorificSuffix__: Not supported, returning `null`.
+
+### FirefoxOS Quirks
+
+- __formatted__: Partially supported, and read-only.  Returns a concatenation of `honorificPrefix`, `givenName`, `middleName`, `familyName`, and `honorificSuffix`.
+
+
+### iOS Quirks
+
+- __formatted__: Partially supported.  Returns iOS Composite Name, but is read-only.
+
+### Windows Quirks
+
+- __formatted__: This is the only name property, and is identical to `displayName`, and `nickname`
+
+- __familyName__: not supported
+
+- __givenName__: not supported
+
+- __middleName__: not supported
+
+- __honorificPrefix__: not supported
+
+- __honorificSuffix__: not supported
+
+
+## ContactOrganization
+
+The `ContactOrganization` object stores a contact's organization
+properties.  A `Contact` object stores one or more
+`ContactOrganization` objects in an array.
+
+### Properties
+
+- __pref__: Set to `true` if this `ContactOrganization` contains the user's preferred value. _(boolean)_
+
+- __type__: A string that indicates what type of field this is, _home_ for example. _(DOMString)
+
+- __name__: The name of the organization. _(DOMString)_
+
+- __department__: The department the contract works for. _(DOMString)_
+
+- __title__: The contact's title at the organization. _(DOMString)_
+
+
+### Supported Platforms
+
+- Android
+- BlackBerry 10
+- Firefox OS
+- iOS
+- Windows Phone 8
+- Windows (Windows 8.1 and Windows Phone 8.1 devices only)
+
+### Example
+
+```js
+function onSuccess(contacts) {
+    for (var i = 0; i < contacts.length; i++) {
+        for (var j = 0; j < contacts[i].organizations.length; j++) {
+            alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                "Department: "  + contacts[i].organizations[j].department + "\n" +
+                "Title: "       + contacts[i].organizations[j].title);
+        }
+    }
+};
+
+function onError(contactError) {
+    alert('onError!');
+};
+
+var options = new ContactFindOptions();
+options.filter = "";
+options.multiple = true;
+filter = ["displayName", "organizations"];
+navigator.contacts.find(filter, onSuccess, onError, options);
+```
+
+### Android 2.X Quirks
+
+- __pref__: Not supported by Android 2.X devices, returning `false`.
+
+### BlackBerry 10 Quirks
+
+- __pref__: Not supported by BlackBerry devices, returning `false`.
+
+- __type__: Not supported by BlackBerry devices, returning `null`.
+
+- __name__: Partially supported.  The first organization name is stored in the BlackBerry __company__ field.
+
+- __department__: Not supported, returning `null`.
+
+- __title__: Partially supported.  The first organization title is stored in the BlackBerry __jobTitle__ field.
+
+### Firefox OS Quirks
+
+- __pref__: Not supported
+
+- __type__: Not supported
+
+- __department__: Not supported
+
+- Fields __name__ and __title__ stored in __org__ and __jobTitle__.
+
+### iOS Quirks
+
+- __pref__: Not supported on iOS devices, returning `false`.
+
+- __type__: Not supported on iOS devices, returning `null`.
+
+- __name__: Partially supported.  The first organization name is stored in the iOS __kABPersonOrganizationProperty__ field.
+
+- __department__: Partially supported.  The first department name is stored in the iOS __kABPersonDepartmentProperty__ field.
+
+- __title__: Partially supported.  The first title is stored in the iOS __kABPersonJobTitleProperty__ field.
+
+### Windows Quirks
+
+- __pref__: Not supported, returning `false`.
+
+- __type__: Not supported, returning `null`.
+
+## ContactFieldType
+The `ContactFieldType` object is an enumeration of possible field types, such as `'phoneNumbers'` or `'emails'`, that could be used to control which contact properties must be returned back from `contacts.find()` method (see `contactFindOptions.desiredFields`), or to specify fields to search in (through `contactFields` parameter). Possible values are:
+
+- `navigator.contacts.fieldType.addresses`
+- `navigator.contacts.fieldType.birthday`
+- `navigator.contacts.fieldType.categories`
+- `navigator.contacts.fieldType.country`
+- `navigator.contacts.fieldType.department`
+- `navigator.contacts.fieldType.displayName`
+- `navigator.contacts.fieldType.emails`
+- `navigator.contacts.fieldType.familyName`
+- `navigator.contacts.fieldType.formatted`
+- `navigator.contacts.fieldType.givenName`
+- `navigator.contacts.fieldType.honorificPrefix`
+- `navigator.contacts.fieldType.honorificSuffix`
+- `navigator.contacts.fieldType.id`
+- `navigator.contacts.fieldType.ims`
+- `navigator.contacts.fieldType.locality`
+- `navigator.contacts.fieldType.middleName`
+- `navigator.contacts.fieldType.name`
+- `navigator.contacts.fieldType.nickname`
+- `navigator.contacts.fieldType.note`
+- `navigator.contacts.fieldType.organizations`
+- `navigator.contacts.fieldType.phoneNumbers`
+- `navigator.contacts.fieldType.photos`
+- `navigator.contacts.fieldType.postalCode`
+- `navigator.contacts.fieldType.region`
+- `navigator.contacts.fieldType.streetAddress`
+- `navigator.contacts.fieldType.title`
+- `navigator.contacts.fieldType.urls`

km0App/node_modules/cordova-plugin-contacts/RELEASENOTES.md

+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+-->
+# Release Notes
+
+### 3.0.1 (Dec 15, 2017)
+* [CB-13062](https://issues.apache.org/jira/browse/CB-13062): Deprecated this plugin. Added notice to README.md
+
+### 3.0.0 (Nov 06, 2017)
+* [CB-13522](https://issues.apache.org/jira/browse/CB-13522) (iOS): Remove usage description
+* [CB-13521](https://issues.apache.org/jira/browse/CB-13521) (all): Add 'protective' entry to `cordovaDependencies`
+* [CB-13472](https://issues.apache.org/jira/browse/CB-13472) (CI) Fixed Travis **Android** builds again
+* [CB-13294](https://issues.apache.org/jira/browse/CB-13294) Remove `cordova-plugin-compat`
+* [CB-13299](https://issues.apache.org/jira/browse/CB-13299) (CI) Fix **Android** builds
+* [CB-12991](https://issues.apache.org/jira/browse/CB-12991) (CI) Updated CI badges
+* [CB-12847](https://issues.apache.org/jira/browse/CB-12847) added `bugs` entry to `package.json`.
+
+### 2.3.1 (Apr 27, 2017)
+* [CB-12622](https://issues.apache.org/jira/browse/CB-12622) Added **Android 6.0** build badge to `README`
+* [CB-10496](https://issues.apache.org/jira/browse/CB-10496) (android) now support data: URIs to save photo for contact by image data base64 encoded
+* [CB-12685](https://issues.apache.org/jira/browse/CB-12685) added `package.json` to tests folder
+* [CB-12622](https://issues.apache.org/jira/browse/CB-12622) (android) Adapt Appium tests for **Android** 6 and 7
+* [CB-10784](https://issues.apache.org/jira/browse/CB-10784) CDVContactsPicker finish animating before callback
+
+### 2.3.0 (Feb 28, 2017)
+* [CB-12326](https://issues.apache.org/jira/browse/CB-12326) **Android:** `CommonDataKinds.*.LABEL`
+* [CB-8076](https://issues.apache.org/jira/browse/CB-8076) Provide error support for **browser** platform
+* [CB-12445](https://issues.apache.org/jira/browse/CB-12445) (Appium) Removed double check for contact's name
+* [CB-12353](https://issues.apache.org/jira/browse/CB-12353) Corrected merges usage in `plugin.xml`
+* [CB-12369](https://issues.apache.org/jira/browse/CB-12369) Add plugin typings from `DefinitelyTyped`
+* [CB-12363](https://issues.apache.org/jira/browse/CB-12363) Added build badges for **iOS 9.3** and ** iOS 10.0**
+* [CB-12357](https://issues.apache.org/jira/browse/CB-12357) Tests give user some time to accept the permission alert
+* [CB-12300](https://issues.apache.org/jira/browse/CB-12300) fix tests failure when running it using `jasmine-node`
+* [CB-12230](https://issues.apache.org/jira/browse/CB-12230) Removed **Windows 8.1** build badges
+
+### 2.2.1 (Dec 07, 2016)
+* [CB-12224](https://issues.apache.org/jira/browse/CB-12224) Updated version and RELEASENOTES.md for release 2.2.1
+* [CB-11541](https://issues.apache.org/jira/browse/CB-11541) Pended one unsupported test on Windows
+* [CB-11541](https://issues.apache.org/jira/browse/CB-11541) iOS: Add extra labels for phone, ims
+* [CB-11028](https://issues.apache.org/jira/browse/CB-11028) android: Allow to set custom labels for contacts' fields
+* [CB-11975](https://issues.apache.org/jira/browse/CB-11975) iOS: Allow to use numeric values in search filter
+* [CB-11206](https://issues.apache.org/jira/browse/CB-11206) (android) Fixed custom IM protocol parsing close #128
+* [CB-11917](https://issues.apache.org/jira/browse/CB-11917) - Remove pull request template checklist item: "iCLA has been signed and submitted to secretary@apache.org."
+* [CB-11350](https://issues.apache.org/jira/browse/CB-11350) android: retrieve displayName for contact when specified in desiredFields
+* [CB-11864](https://issues.apache.org/jira/browse/CB-11864) Fixed tests for the new Jasmine version
+* [CB-11832](https://issues.apache.org/jira/browse/CB-11832) Incremented plugin version.
+
+### 2.2.0 (Sep 08, 2016)
+* [CB-11795](https://issues.apache.org/jira/browse/CB-11795) Add 'protective' entry to cordovaDependencies
+* Added variable to set the usage
+* Plugin uses `Android Log class` and not `Cordova LOG class`
+* [CB-11695](https://issues.apache.org/jira/browse/CB-11695) Increased session creation timeout for Appium tests
+* [CB-11667](https://issues.apache.org/jira/browse/CB-11667) Memory leak in `CDVContact` for `CoreFoundation` `ABRecordRef`
+* [CB-11574](https://issues.apache.org/jira/browse/CB-11574) Appium tests now use new injected promise chain methods
+* Add badges for paramedic builds on Jenkins
+* [CB-11296](https://issues.apache.org/jira/browse/CB-11296) Appium: Better element clicking and session error handling
+* Add pull request template.
+* Add fenced code blocks - with language hints
+* handle `Invalid Date` error
+* [CB-11166](https://issues.apache.org/jira/browse/CB-11166) Appium tests: Added a check for contact's birthday
+* [CB-11033](https://issues.apache.org/jira/browse/CB-11033) Appium tests: more timeout tweaks
+* [CB-10996](https://issues.apache.org/jira/browse/CB-10996) Adding front matter to `README.md`
+* [CB-11128](https://issues.apache.org/jira/browse/CB-11128) Appium tests: Increased session destruction timeout
+
+### 2.1.0 (Apr 15, 2016)
+* [CB-11043](https://issues.apache.org/jira/browse/CB-11043) **Android** app crashes while trying to save contact with phone numbers array with deleted values
+* [CB-10985](https://issues.apache.org/jira/browse/CB-10985) Android sets type to `-1` for ims Added a corresponding test
+* [CB-11048](https://issues.apache.org/jira/browse/CB-11048) Fix spec27's inadvertant breakage that happened during logging rollback
+* [CB-11041](https://issues.apache.org/jira/browse/CB-11041) `cordova-plugin-contacts` readme must be updated to include instructions on removing phone number from a contact
+* [CB-11033](https://issues.apache.org/jira/browse/CB-11033) Appium tests: Increased the timeout for updating the contact
+* [CB-10399](https://issues.apache.org/jira/browse/CB-10399) Added Appium tests
+* Replace `PermissionHelper.java` with `cordova-plugin-compat`
+* [CB-8115](https://issues.apache.org/jira/browse/CB-8115) incorrect birthday saved to phonebook using Contacts Plugin
+* Changes to stop using global object - remove all created contacts from the emulator
+* [CB-10881](https://issues.apache.org/jira/browse/CB-10881) Increase timeout for Spec22
+* Fix for the specs 26&27 to use the newly created contacts for removal test
+* [CB-10881](https://issues.apache.org/jira/browse/CB-10881) Remove test dependency on global object
+* [CB-10632](https://issues.apache.org/jira/browse/CB-10632) Fixing jasmine test contact removal
+* [CB-10636](https://issues.apache.org/jira/browse/CB-10636) Add `JSHint` for plugins
+
+### 2.0.1 (Jan 15, 2016)
+* [CB-10159](https://issues.apache.org/jira/browse/CB-10159) **Android** Adding restore callback to handle Activity destruction
+* [CB-10319](https://issues.apache.org/jira/browse/CB-10319) **Android** Adding reflective helper methods for permission requests
+* [CB-10117](https://issues.apache.org/jira/browse/CB-10117) Added new tests
+* [CB-10131](https://issues.apache.org/jira/browse/CB-10131) Fixed null contact creation.
+* [CB-10053](https://issues.apache.org/jira/browse/CB-10053) Documents `ContactFieldType` enumeration. 
+* [CB-10148](https://issues.apache.org/jira/browse/CB-10148) **Android** Added `READ_CONTACTS` permission request when picking a contact
+* [CB-10053](https://issues.apache.org/jira/browse/CB-10053) Accept assets `URIs` for contact photos
+* [CB-8115](https://issues.apache.org/jira/browse/CB-8115) Save contact birthday properly
+* [CB-6979](https://issues.apache.org/jira/browse/CB-6979) Don't create duplicates for extracted contacts photos
+* [CB-5308](https://issues.apache.org/jira/browse/CB-5308) Makes contacts save specs passing
+* [CB-5308](https://issues.apache.org/jira/browse/CB-5308) Return `rawId` instead of id when modifying existing contact
+* [CB-4921](https://issues.apache.org/jira/browse/CB-4921) Corrects examples by adding missing `multiple` option where multiple contacts are expected
+* [CB-10094](https://issues.apache.org/jira/browse/CB-10094) **Android** Fixed empty string comparison
+* [CB-3950](https://issues.apache.org/jira/browse/CB-3950) Adds support for custom labels
+* [CB-9770](https://issues.apache.org/jira/browse/CB-9770) Request user permissions before picking a contact
+* [CB-8156](https://issues.apache.org/jira/browse/CB-8156) Call error callback on `pickContact` cancellation
+* [CB-7906](https://issues.apache.org/jira/browse/CB-7906) Prevent app crash when `desiredFields` option has undefined items
+* [CB-7021](https://issues.apache.org/jira/browse/CB-7021) Adds manual test for `pickContact`
+
+### 2.0.0 (Nov 18, 2015)
+* [CB-10035](https://issues.apache.org/jira/browse/CB-10035) Updated `RELEASENOTES` to be newest to oldest
+* [CB-9728](https://issues.apache.org/jira/browse/CB-9728) Solving memory leak issues due to opened cursor objects
+* [CB-9940](https://issues.apache.org/jira/browse/CB-9940) Adding namespace declarations for `m3` and uap to `plugin.xml`. 
+* [CB-9905](https://issues.apache.org/jira/browse/CB-9905) mark tests as pending if **iOS** permission is blocked.
+* Refactored `ContactManager` after feedback
+* Commit of Contacts Plugin with new `API` for new **MarshMallow** permissions for **Android 6.0**
+* Fixing contribute link.
+* [CB-9823](https://issues.apache.org/jira/browse/CB-9823) Making sure the `photoCursor` is always closed.
+* Shortened multiple references to use `CommonDataKinds` directly
+* removed mulitple calls `toLowerCase(Locale.getDefault())` for the same string, use type Phone `enum` directly.
+* [CB-8537](https://issues.apache.org/jira/browse/CB-8537) Updated source to pass `Fortify` scan.
+* Update `ContactProxy.js`
+* Do not return absolute path for contact images.
+* [CB-9579](https://issues.apache.org/jira/browse/CB-9579) Fixed failed tests when `DeleteMe` contact already exists
+* [CB-9054](https://issues.apache.org/jira/browse/CB-9054): Can't fully reproduce, but we should probably wrap this in an exception anyway.
+
+### 1.1.0 (Jun 17, 2015)
+* [CB-9128](https://issues.apache.org/jira/browse/CB-9128) cordova-plugin-contacts documentation translation: cordova-plugin-contacts
+* fix npm md issue
+* Add more install text for legacy versions of cordova tools. This closes #60
+* [CB-9056](https://issues.apache.org/jira/browse/CB-9056) Increased timeout of failing tests
+* [CB-8987](https://issues.apache.org/jira/browse/CB-8987): Support for save and remove for Windows 10
+* [CB-5278](https://issues.apache.org/jira/browse/CB-5278): We must close the cursor or we take down the whole app, and the debugger doesn't catch it.
+
+### 1.0.0 (Apr 15, 2015)
+* [CB-8746](https://issues.apache.org/jira/browse/CB-8746) gave plugin major version bump
+* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) updated wp specific references of old id to new id
+* [CB-8683](https://issues.apache.org/jira/browse/CB-8683) changed plugin-id to pacakge-name
+* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) properly updated translated docs to use new id
+* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) updated translated docs to use new id
+* Use TRAVIS_BUILD_DIR, install paramedic by npm
+* [CB-8653](https://issues.apache.org/jira/browse/CB-8653) Updated Readme
+* [CB-8659](https://issues.apache.org/jira/browse/CB-8659): ios: 4.0.x Compatibility: Remove use of initWebView method
+* [CB-8659](https://issues.apache.org/jira/browse/CB-8659): ios: 4.0.x Compatibility: Remove use of deprecated headers
+* [CB-8604](https://issues.apache.org/jira/browse/CB-8604) Pended unsupported test for wp8, updated documentation
+* [CB-8561](https://issues.apache.org/jira/browse/CB-8561) Integrate TravisCI
+* [CB-8438](https://issues.apache.org/jira/browse/CB-8438) cordova-plugin-contacts documentation translation: cordova-plugin-contacts
+* [CB-8538](https://issues.apache.org/jira/browse/CB-8538) Added package.json file
+* windows: pended .remove test as it is not supported on windows
+* [CB-8395](https://issues.apache.org/jira/browse/CB-8395) marked unsupported tests pending on wp8
+
+### 0.2.16 (Feb 04, 2015)
+* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) ios: Stop using (newly) deprecated CordovaLib functions
+* [CB-8351](https://issues.apache.org/jira/browse/CB-8351) ios: Use argumentForIndex rather than NSArray extension
+* android: Update ContactName support
+* Updated the comments for ContactOrganization constructor.
+
+### 0.2.15 (Dec 02, 2014)
+* [CB-7131](https://issues.apache.org/jira/browse/CB-7131) Check for profile photo existance
+* [CB-7896](https://issues.apache.org/jira/browse/CB-7896) Better way to detect **Windows** and **WindowsPhone8.1**
+* [CB-7896](https://issues.apache.org/jira/browse/CB-7896) Pending tests for `Save` and `Find` methods for **Windows** cause they are not supported yet
+* [CB-7977](https://issues.apache.org/jira/browse/CB-7977) Mention `deviceready` in plugin docs
+* [CB-7772](https://issues.apache.org/jira/browse/CB-7772) - [Contacts] Cancelling `pickContact` should call the error callback, not the success callback
+* [CB-7761](https://issues.apache.org/jira/browse/CB-7761) - Misleading text in documentation
+* [CB-7762](https://issues.apache.org/jira/browse/CB-7762) - Parameter list is incorrect for `contacts.find`
+* [CB-7700](https://issues.apache.org/jira/browse/CB-7700) cordova-plugin-contacts documentation translation: cordova-plugin-contacts
+
+### 0.2.14 (Oct 03, 2014)
+* [CB-7373](https://issues.apache.org/jira/browse/CB-7373) Removes unnecessary Error object creation
+* [CB-7373](https://issues.apache.org/jira/browse/CB-7373) Adds additional output if method is not supported.
+* [CB-7357](https://issues.apache.org/jira/browse/CB-7357) Adds missing 'capability' element to phone's appxmanifest.
+
+### 0.2.13 (Sep 17, 2014)
+* [CB-7546](https://issues.apache.org/jira/browse/CB-7546) [Contacts][iOS] pickContact shows exception in the console log
+* [CB-6374](https://issues.apache.org/jira/browse/CB-6374) Fix iOS 6 deprecation warnings in Contacts
+* [CB-7544](https://issues.apache.org/jira/browse/CB-7544) [Contacts][iOS 8] Contact picker is read-only in iOS 8
+* [CB-7523](https://issues.apache.org/jira/browse/CB-7523) Fixing "ContactFieldType" error in the config.xml
+* [CB-6724](https://issues.apache.org/jira/browse/CB-6724) Empty may be expected.
+* [CB-7249](https://issues.apache.org/jira/browse/CB-7249) cordova-plugin-contacts documentation translation
+* Add missing test, skip some specs on wp
+* rm old test folder and merged with renamed tests folder
+* [CB-7290](https://issues.apache.org/jira/browse/CB-7290) Adds support for universal Windows platform.
+* Renamed test dir, added nested plugin.xml
+* [CB-7148](https://issues.apache.org/jira/browse/CB-7148) Added manual tests
+* Removed js-module for tests from plugin.xml
+* Changing cdvtest format to use module exports
+* register tests using new style
+* convert test to new style
+* added documentation for manual tests
+* merged changes for test framework plugin
+
+### 0.2.12 (Aug 06, 2014)
+* fixes .find method when 'options' param is not passed. Will return all contacts on missing 'options' param
+* [FFOS] update ContactsProxy.js
+* Removing a stray unicode character
+* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Updated translations for docs
+* [CB-5698](https://issues.apache.org/jira/browse/CB-5698) ios: Check to see if photoData exists before using
+
+### 0.2.11 (Jul 2, 2014)
+* [CB-6127](https://issues.apache.org/jira/browse/CB-6127) Spanish and French Translations added. Github close #25
+* Remove deprecated symbols for iOS < 6
+* [CB-6797](https://issues.apache.org/jira/browse/CB-6797) Add license
+* [wp8] now pupulates contact photos
+* Update license headers format
+* Add pickContact functionality to cordova contacts plugin
+* [CB-5416](https://issues.apache.org/jira/browse/CB-5416) - Adding support for auto-managing permissions
+* [CB-6682](https://issues.apache.org/jira/browse/CB-6682) move windows8 command proxy into it's missing platform tag. This closes #30
+* Add ContactError codes to index.md doc (closes #28)
+* [CB-6491](https://issues.apache.org/jira/browse/CB-6491) add CONTRIBUTING.md
+* Docs typo: navigator.contacts.length -> contacts.length
+* [CB-5698](https://issues.apache.org/jira/browse/CB-5698) ios: Check to see if photoData exists before using
+* [CB-7003](https://issues.apache.org/jira/browse/CB-7003) android: Make pickContact pick correct contact on Android 4.3 and 4.4.3
+
+### 0.2.10 (Apr 17, 2014)
+* [CB-6126](https://issues.apache.org/jira/browse/CB-6126): [BlackBerry10] Update docs quirks section for fields which are supported
+* [CB-6212](https://issues.apache.org/jira/browse/CB-6212): [iOS] fix warnings compiled under arm64 64-bit
+* [CB-6460](https://issues.apache.org/jira/browse/CB-6460): Update license headers
+* Add NOTICE file
+
+### 0.2.9 (Feb 26, 2014)
+* [CB-6086](https://issues.apache.org/jira/browse/CB-6086) Fix typo in ffos part of plugin.xml: Camera -> Contacts
+* [CB-5994](https://issues.apache.org/jira/browse/CB-5994) Switch Contact ID lookup to use Raw contact id.
+
+### 0.2.8 (Feb 05, 2014)
+* [CB-3208](https://issues.apache.org/jira/browse/CB-3208) FFOS docs updated
+* [CB-4590](https://issues.apache.org/jira/browse/CB-4590) - chooseContact in CDVContacts crashes app
+
+### 0.2.7 (Jan 02, 2014)
+* B-5658 Add doc/index.md for Contacts plugin
+
+### 0.2.6 (Dec 4, 2013)
+* Fix bad commit/merge
+* [CB-3035](https://issues.apache.org/jira/browse/CB-3035) Fix issue with windows new line char \n\r
+* wrong example given
+* docs added
+* FxOS name fields are arrays hackedSearch refactored search based on find commented out
+* search hacked via getAll
+* search added - no idea if this is working
+* createMozillaFromCordova and vice versa are used to translate contact objects from one API to another.
+* add/remove working
+* save is working
+* attempt to save is failing trying to limit the translated contact fields to name and familyName, but still failing
+* save is linked with the proxy contact.name doesn't exist www/Contact.js#Contact.prototype.save check on which side is the error
+* [CB-5214](https://issues.apache.org/jira/browse/CB-5214) Make mobile spec tests on WP8 to run w/o user interaction + Sync with cordova-mobile-spec
+* [CB-5525](https://issues.apache.org/jira/browse/CB-5525) WP8. Contacts Api fails in case of there is special character in contact field
+* fixed ubuntu policy error
+* [ubuntu] specify policy_group
+* add ubuntu platform
+* [CB-3035](https://issues.apache.org/jira/browse/CB-3035) Fix issue with windows new line char \n\r
+* 1. Added amazon-fireos platform. 2. Change to use amazon-fireos as the platform if user agent string contains 'cordova-amazon-fireos'.
+* [CB-5198](https://issues.apache.org/jira/browse/CB-5198) [BlackBerry10] Update dependencies to point to registry
+* handle null filter when fields are specified. ( long standing pull-req from @kevfromireland )
+
+### 0.2.5 (Oct 28, 2013)
+* [CB-5128](https://issues.apache.org/jira/browse/CB-5128): added repo + issue tags for contacts
+* [CB-5010](https://issues.apache.org/jira/browse/CB-5010) Incremented plugin version on dev branch.
+
+### 0.2.4 (Oct 9, 2013)
+* [CB-4950](https://issues.apache.org/jira/browse/CB-4950) Remove the dependence on concrete component android.webkit.WebView.
+* [CB-4915](https://issues.apache.org/jira/browse/CB-4915) Incremented plugin version on dev branch.
+
+### 0.2.3 (Sept 25, 2013)
+* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) bumping&resetting version
+* [BlackBerry10] removed uneeded permission tags in plugin.xml
+* [CB-4889](https://issues.apache.org/jira/browse/CB-4889) renaming blackberry10 reference in plugin.xml
+* [CB-4888](https://issues.apache.org/jira/browse/CB-4888) renaming org.apache.cordova.core.contacts to org.apache.cordova.contacts
+* added contacts api for firefoxos
+* Rename CHANGELOG.md -> RELEASENOTES.md
+* [CB-4824](https://issues.apache.org/jira/browse/CB-4824) Fix XCode 5 contacts plugin warnings
+* [CB-4752](https://issues.apache.org/jira/browse/CB-4752) Incremented plugin version on dev branch.
+
+### 0.2.1 (Sept 5, 2013)
+* [CB-4580](https://issues.apache.org/jira/browse/CB-4580) Fixed up duplicate definitions of module id
+* [CB-4432](https://issues.apache.org/jira/browse/CB-4432) Copyright notice change
+

km0App/node_modules/cordova-plugin-contacts/appium-tests/common/common.spec.js

+/*jshint node: true, jasmine: true, browser: true */
+/*global ContactFindOptions, ContactName, Q*/
+
+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+// these tests are meant to be executed by Cordova Medic Appium runner
+// you can find it here: https://github.com/apache/cordova-medic/
+// it is not necessary to do a full CI setup to run these tests, just run:
+// node cordova-medic/medic/medic.js appium --platform android --plugins cordova-plugin-contacts
+
+'use strict';
+
+var wdHelper = global.WD_HELPER;
+var screenshotHelper = global.SCREENSHOT_HELPER;
+var contactsHelper = require('../helpers/contactsHelper');
+
+var MINUTE = 60 * 1000;
+var PLATFORM = global.PLATFORM;
+var UNORM = global.UNORM;
+
+describe('Contacts UI Automation Tests', function () {
+    var driver;
+    var webviewContext;
+    var promiseCount = 0;
+    // going to set this to false if session is created successfully
+    var failedToStart = true;
+
+    function getNextPromiseId() {
+        return 'appium_promise_' + promiseCount++;
+    }
+
+    function saveScreenshotAndFail(error) {
+        fail(error);
+        return screenshotHelper
+            .saveScreenshot(driver)
+            .quit()
+            .then(function () {
+                return getDriver();
+            });
+    }
+
+    function getDriver() {
+        driver = wdHelper.getDriver(PLATFORM);
+        return wdHelper.getWebviewContext(driver, 2)
+            .then(function (context) {
+                webviewContext = context;
+                return driver.context(webviewContext);
+            })
+            .then(function () {
+                return wdHelper.waitForDeviceReady(driver);
+            })
+            .then(function () {
+                return wdHelper.injectLibraries(driver);
+            });
+    }
+
+    function addContact(firstName, lastName, bday) {
+        var bdayString = bday ? bday.toDateString() : undefined;
+        var contactName = contactsHelper.getContactName(firstName, lastName);
+        return driver
+            .context(webviewContext)
+            .setAsyncScriptTimeout(MINUTE)
+            .executeAsync(function (contactname, bday, callback) {
+                navigator.contacts.create({
+                    'displayName': contactname.formatted,
+                    'name': contactname,
+                    'note': 'DeleteMe',
+                    'birthday': new Date(bday)
+                }).save(function (successResult) {
+                    callback(successResult);
+                }, function (failureResult) {
+                    callback(failureResult);
+                });
+            }, [contactName, bdayString])
+            .then(function (result) {
+                if (result && result.hasOwnProperty('code')) {
+                    throw result;
+                }
+                return result;
+            });
+    }
+
+    function pickContact(name) {
+        var promiseId = getNextPromiseId();
+        return driver
+            .context(webviewContext)
+            .execute(function (pID) {
+                navigator._appiumPromises[pID] = Q.defer();
+                navigator.contacts.pickContact(function (contact) {
+                    navigator._appiumPromises[pID].resolve(contact);
+                }, function (err) {
+                    navigator._appiumPromises[pID].reject(err);
+                });
+            }, [promiseId])
+            .context('NATIVE_APP')
+            .then(function () {
+                switch (PLATFORM) {
+                    case 'ios':
+                        return driver
+                            .waitForElementByAccessibilityId(name, 20000)
+                            .elementByAccessibilityId(name);
+                    case 'android':
+                        return driver
+                            .waitForElementByXPath('//android.widget.TextView[@text="' + name + '"]', MINUTE);
+                }
+            })
+            .click()
+            .context(webviewContext)
+            .executeAsync(function (pID, cb) {
+                navigator._appiumPromises[pID].promise
+                .then(function (contact) {
+                    // for some reason Appium cannot get Date object
+                    // let's make birthday a string then
+                    contact.birthday = contact.birthday.toDateString();
+                    cb(contact);
+                }, function (err) {
+                    cb('ERROR: ' + err);
+                });
+            }, [promiseId])
+            .then(function (result) {
+                if (typeof result === 'string' && result.indexOf('ERROR:') === 0) {
+                    throw result;
+                }
+                return result;
+            });
+    }
+
+    function renameContact(oldName, newGivenName, newFamilyName) {
+        return driver
+            .context(webviewContext)
+            .setAsyncScriptTimeout(7 * MINUTE)
+            .executeAsync(function (oldname, newgivenname, newfamilyname, callback) {
+                var obj = new ContactFindOptions();
+                obj.filter = oldname;
+                obj.multiple = false;
+
+                navigator.contacts.find(['displayName', 'name'], function (contacts) {
+                    if (contacts.length === 0) {
+                        callback({ 'code': -35142 });
+                        return;
+                    }
+                    var contact = contacts[0];
+                    contact.displayName = newgivenname + ' ' + newfamilyname;
+                    var name = new ContactName();
+                    name.givenName = newgivenname;
+                    name.familyName = newfamilyname;
+                    contact.name = name;
+                    contact.save(callback, callback);
+                }, function (result) {
+                    callback(result);
+                }, obj);
+            }, [oldName, newGivenName, newFamilyName])
+            .then(function (result) {
+                if (result && result.hasOwnProperty('code')) {
+                    if (result.code === -35142) {
+                        throw 'Couldn\'t find the contact "' + oldName + '"';
+                    }
+                    throw result;
+                }
+                return result;
+            });
+    }
+
+    function removeTestContacts() {
+        return driver
+            .context(webviewContext)
+            .setAsyncScriptTimeout(MINUTE)
+            .executeAsync(function (callback) {
+                var obj = new ContactFindOptions();
+                obj.filter = 'DeleteMe';
+                obj.multiple = true;
+                navigator.contacts.find(['note'], function (contacts) {
+                    var removes = [];
+                    contacts.forEach(function (contact) {
+                        removes.push(contact);
+                    });
+                    if (removes.length === 0) {
+                        return;
+                    }
+
+                   var nextToRemove;
+                   if (removes.length > 0) {
+                        nextToRemove = removes.shift();
+                    }
+
+                    function removeNext(item) {
+                        if (typeof item === 'undefined') {
+                            callback();
+                            return;
+                        }
+
+                        if (removes.length > 0) {
+                            nextToRemove = removes.shift();
+                        } else {
+                            nextToRemove = undefined;
+                        }
+
+                        item.remove(function removeSucceeded() {
+                            removeNext(nextToRemove);
+                        }, function removeFailed() {
+                            removeNext(nextToRemove);
+                        });
+                    }
+                    removeNext(nextToRemove);
+                }, function (failureResult) {
+                    callback(failureResult);
+                }, obj);
+            }, [])
+            .then(function (result) {
+                if (typeof result !== 'undefined') {
+                    throw result;
+                }
+            });
+    }
+
+    function checkSession(done) {
+        if (failedToStart) {
+            fail('Failed to start a session');
+            done();
+        }
+    }
+
+    afterAll(function (done) {
+        checkSession(done);
+        driver
+            .quit()
+            .done(done);
+    }, MINUTE);
+
+    it('should connect to an appium endpoint properly', function (done) {
+        // retry up to 3 times
+        getDriver()
+            .fail(function () {
+                return getDriver()
+                    .fail(function () {
+                        return getDriver()
+                            .fail(fail);
+                    });
+            })
+            .then(function () {
+                failedToStart = false;
+            }, fail)
+            .then(function () {
+                // on iOS and Android >= 6, first interaction with contacts API will trigger the permission dialog.
+                // We will attempt to bust it manually here, by triggering the contacts API
+                // and waiting for the native dialog to show up, then dismissing the alert.
+                // This only needs to be done once.
+                // NOTE: in earlier versions of iOS (9.3 and below), using the older UI testing library
+                // (UIAutomation), Appium's autoAcceptAlerts capability handles this for us. This logic
+                // is here as a transition between UIAutomation and XCUITest and is compatible with both.
+                // More details in the comment below.
+                var promiseId = getNextPromiseId();
+                var contactName = contactsHelper.getContactName('Permission', 'Buster');
+                return driver
+                    .context(webviewContext)
+                    .execute(function (pID, contactname) {
+                        navigator._appiumPromises[pID] = Q.defer();
+                        navigator.contacts.create({
+                            'displayName': contactname.formatted,
+                            'name': contactname,
+                            'note': 'DeleteMe'
+                        }).save(function (contact) {
+                            navigator._appiumPromises[pID].resolve(contact);
+                        }, function (err) {
+                            navigator._appiumPromises[pID].reject(err);
+                        });
+                    }, [promiseId, contactName])
+                    .context('NATIVE_APP')
+                    .then(function () {
+                        // iOS
+                        if (PLATFORM === 'ios') {
+                            return driver.acceptAlert()
+                                .then(function alertDismissed() {
+                                    // TODO: once we move to only XCUITest-based (which is force on you in either iOS 10+ or Xcode 8+)
+                                    // UI tests, we will have to:
+                                    // a) remove use of autoAcceptAlerts appium capability since it no longer functions in XCUITest
+                                    // b) can remove this entire then() clause, as we do not need to explicitly handle the acceptAlert
+                                    //    failure callback, since we will be guaranteed to hit the permission dialog on startup.
+                                 }, function noAlert() {
+                                     // in case the contacts permission alert never showed up: no problem, don't freak out.
+                                     // This can happen if:
+                                     // a) The application-under-test already had contacts permissions granted to it
+                                     // b) Appium's autoAcceptAlerts capability is provided (and functioning)
+                                 });
+                        }
+
+                        // Android
+                        return driver
+                            .elementByXPath('//android.widget.Button[translate(@text, "alow", "ALOW")="ALLOW"]')
+                            .click()
+                            .fail(function noAlert() { });
+                    })
+                    .context(webviewContext)
+                    .executeAsync(function (pID, cb) {
+                        navigator._appiumPromises[pID].promise
+                            .then(function (result) {
+                                cb(result);
+                            }, function (err) {
+                                cb('ERROR: ' + err);
+                            });
+                    }, [promiseId])
+                    .then(function (result) {
+                        if (typeof result === 'string' && result.indexOf('ERROR:') === 0) {
+                            throw result;
+                        }
+                        return result;
+                    });
+            })
+            .done(done);
+    }, 30 * MINUTE);
+
+    describe('Picking contacts', function () {
+        afterEach(function (done) {
+            checkSession(done);
+            removeTestContacts()
+                .finally(done);
+        }, MINUTE);
+
+        it('contacts.ui.spec.1 Pick a contact', function (done) {
+            checkSession(done);
+            var bday = new Date(1991, 1, 1);
+            driver
+                .then(function () {
+                    return addContact('Test', 'Contact', bday);
+                })
+                .then(function () {
+                    return pickContact('Test Contact');
+                })
+                .then(function (contact) {
+                    expect(contact.name.givenName).toBe('Test');
+                    expect(contact.name.familyName).toBe('Contact');
+                    expect(contact.birthday).toBe(bday.toDateString());
+                })
+                .fail(saveScreenshotAndFail)
+                .done(done);
+        }, 5 * MINUTE);
+
+        it('contacts.ui.spec.2 Update an existing contact', function (done) {
+            checkSession(done);
+            driver
+                .then(function () {
+                    return addContact('Dooney', 'Evans');
+                })
+                .then(function () {
+                    return renameContact('Dooney Evans', 'Urist', 'McContact');
+                })
+                .then(function () {
+                    return pickContact('Urist McContact');
+                })
+                .then(function (contact) {
+                    expect(contact.name.givenName).toBe('Urist');
+                    expect(contact.name.familyName).toBe('McContact');
+                })
+                .fail(saveScreenshotAndFail)
+                .done(done);
+        }, 10 * MINUTE);
+
+        it('contacts.ui.spec.3 Create a contact with no name', function (done) {
+            checkSession(done);
+            driver
+                .then(function () {
+                    return addContact();
+                })
+                .then(function () {
+                    switch (PLATFORM) {
+                        case 'android':
+                            return pickContact('(No name)');
+                        case 'ios':
+                            return pickContact('No Name');
+                    }
+                })
+                .then(function (contact) {
+                    if (contact.name) {
+                        expect(contact.name.givenName).toBeFalsy();
+                        expect(contact.name.middleName).toBeFalsy();
+                        expect(contact.name.familyName).toBeFalsy();
+                        expect(contact.name.formatted).toBeFalsy();
+                    } else {
+                        expect(contact.name).toBeFalsy();
+                    }
+                })
+                .fail(saveScreenshotAndFail)
+                .done(done);
+        }, 5 * MINUTE);
+
+        it('contacts.ui.spec.4 Create a contact with Unicode characters in name', function (done) {
+            checkSession(done);
+            driver
+                .then(function () {
+                    return addContact('Н€йромонах', 'ФеофаЊ');
+                })
+                .then(function () {
+                    return pickContact('Н€йромонах ФеофаЊ');
+                })
+                .then(function (contact) {
+                    expect(contact.name.givenName).toBe('Н€йромонах');
+                    expect(contact.name.familyName).toBe('ФеофаЊ');
+                })
+                .fail(saveScreenshotAndFail)
+                .done(done);
+        }, 5 * MINUTE);
+    });
+});

km0App/node_modules/cordova-plugin-contacts/appium-tests/helpers/contactsHelper.js

+/* jshint node: true */
+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+'use strict';
+
+module.exports.getContactName = function (firstName, lastName) {
+    var formattedName;
+    if (typeof firstName !== 'undefined' || typeof lastName !== 'undefined') {
+        var delimiter = '';
+        if (firstName) {
+            delimiter = ' ';
+        }
+        formattedName = firstName + delimiter + lastName;
+    }
+
+    var contactName = {
+        formatted: formattedName,
+        familyName: lastName,
+        givenName: firstName
+    };
+    return contactName;
+};

km0App/node_modules/cordova-plugin-contacts/doc/de/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Dieses Plugin definiert eine globale `navigator.contacts`-Objekt bietet Zugriff auf die Geräte-Kontakte-Datenbank.
+
+Obwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**Warnung**: Erhebung und Nutzung von Kontaktdaten löst wichtige Datenschutzprobleme. Ihre app-Datenschutzerklärung sollten besprechen, wie die app Kontaktdaten verwendet und ob es mit irgendwelchen anderen Parteien geteilt wird. Kontaktinformationen ist als vertraulich angesehen, weil es die Menschen zeigt, mit denen eine Person kommuniziert. Daher neben der app-Privacy Policy sollten stark Sie Bereitstellung eine just-in-Time-Bekanntmachung, bevor die app zugreift oder Kontaktdaten verwendet, wenn Betriebssystem des Geräts nicht dies bereits tun. Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das **OK** und **Nein danke**). Beachten Sie, dass einige app-Marktplätze die app eine Frist eine just-in-Time und erhalten die Erlaubnis des Benutzers vor dem Zugriff auf Kontaktdaten verlangen können. Eine klare und leicht verständliche Benutzererfahrung rund um die Verwendung der Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
+
+## Installation
+
+Dies erfordert Cordova 5.0 + (aktuelle stabile v1)
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+Ältere Versionen von Cordova können noch über die Id **veraltet** (veraltet v0.2.16) installieren.
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+Es ist auch möglich, über Repo Url direkt zu installieren (unstable)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### Firefox OS Macken
+
+Erstellen Sie **www/manifest.webapp**, wie in [Docs Manifest](https://developer.mozilla.org/en-US/Apps/Developing/Manifest) beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privileged" - [Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type) ändern. **Warnung**: alle privilegierten apps [Content Security Policy](https://developer.mozilla.org/en-US/Apps/CSP), welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows-Eigenheiten
+
+**Vor Windows 10:** Alle Kontakte von `finden` und `PickContact` -Methoden zurückgegebenen sind Readonly, so dass sie von die Anwendung nicht geändert werden kann. `find`-Methode nur auf Windows Phone 8.1-Geräten verfügbar.
+
+**Windows 10 und höher:** Kontakte können gespeichert werden und in den app-lokale Kontakte-Speicher gespeichert werden. Kontakte können auch gelöscht werden.
+
+### Windows 8 Macken
+
+Windows 8 Kontakte sind Readonly. Über die Cordova-API-Kontakte nicht abgefragt werden/können durchsucht werden, Sie sollten den Benutzer informieren, wählen Sie einen Kontakt als Aufruf an contacts.pickContact, die 'People'-app öffnet, wo muss der Benutzer einen Kontakt auswählen. Alle zurückgegebenen Kontakte sind Readonly, so dass sie von die Anwendung nicht geändert werden kann.
+
+## Navigator.Contacts
+
+### Methoden
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### Objekte
+
+  * Kontakt
+  * ContactName
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+Die `navigator.contacts.create`-Methode ist synchron und gibt ein neues `Contact` objekt.
+
+Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank, für die Sie benötigen, um die `Contact.save`-Methode aufzurufen.
+
+### Unterstützte Plattformen
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+
+### Beispiel
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Die `navigator.contacts.find`-Methode führt asynchron, Abfragen der Gerät-Kontakte-Datenbank und gibt ein Array von `Contact`-Objekte. Die resultierenden Objekte werden an die durch den **contactSuccess**-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.
+
+Der **contactFields**-Parameter gibt die Felder als Qualifizierer Suche verwendet werden. Ein leere **contactFields**-Parameter ist ungültig und führt zu `ContactError.INVALID_ARGUMENT_ERROR`. **contactFields** Wert `"*"` sucht alle Kontaktfelder.
+
+Die **contactFindOptions.filter**-Zeichenfolge kann als einen Suchfilter verwendet, wenn die Kontaktdatenbank Abfragen. Wenn angeboten, ein groß-und Kleinschreibung, wird jedes Feld in der **contactFields**-Parameter angegebenen Teilwert Übereinstimmung. Wenn eine Übereinstimmung für *alle* angegebenen Felder vorliegt, wird der Kontakt zurückgegeben. Verwendung **contactFindOptions.desiredFields** Parameter steuern, welche Eigenschaften kontaktieren muss wieder zurückgegeben werden.
+
+### Parameter
+
+  * **contactFields**: Kontaktfelder als Qualifizierer Suche verwenden. *(DOMString[])* [Required]
+
+  * **contactSuccess**: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Required]
+
+  * **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+
+  * **contactFindOptions**: Optionen zum Filtern von navigator.contacts zu suchen. [Optional]
+    
+    Schlüssel enthalten:
+    
+      * **filter**: die zu suchende Zeichenfolge verwendet, um navigator.contacts zu finden. *(DOM-String und enthält)* (Standard: `""`)
+    
+      * **multiple**: bestimmt, ob der Suchvorgang mehrere navigator.contacts gibt. *(Boolesch)* (Standard: `false`)
+        
+          * **desiredFields**: Kontaktfelder wieder zurückgegeben werden. Wenn angegeben, Objekt der daraus resultierenden `Contact` nur Funktionen Werte für diese Felder. *(DOMString[])* [Optional]
+
+### Unterstützte Plattformen
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+  * Windows (Windows Phone 8.1 und Windows 10)
+
+### Beispiel
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows-Eigenheiten
+
+  * `__contactFields__`wird nicht unterstützt und wird ignoriert. `find`Methode wird immer versucht, die Namen, e-Mail-Adresse oder Telefonnummer eines Kontakts übereinstimmen.
+
+## navigator.contacts.pickContact
+
+Die `navigator.contacts.pickContact`-Methode startet im Kontakt Farbwähler wählen Sie einen einzigen Ansprechpartner. Das resultierende Objekt wird an die durch den **contactSuccess**-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.
+
+### Parameter
+
+  * **ContactSuccess**: Erfolg-Callback-Funktion, die mit den einzelnen Kontakt-Objekt aufgerufen. [Erforderlich]
+
+  * **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+
+### Unterstützte Plattformen
+
+  * Android
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### Beispiel
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Kontakt
+
+Das `Contact`-Objekt repräsentiert einen Benutzer Kontakt. Kontakte können erstellt, gespeichert oder aus der Gerät-Kontakte-Datenbank entfernt werden. Kontakte können auch (einzeln oder als Gruppe) aus der Datenbank abgerufen werden durch Aufrufen der `navigator.contacts.find`-Methode.
+
+**Hinweis**: nicht alle oben aufgeführten Kontaktfelder werden auf jedes Geräteplattform unterstützt. Bitte überprüfen Sie jede Plattform *Quirks* Abschnitt für Details.
+
+### Eigenschaften
+
+  * **ID**: einen globally unique Identifier. *(DOM-String und enthält)*
+
+  * **DisplayName**: der Name dieses Kontakts, geeignet für die Anzeige für Endbenutzer. *(DOM-String und enthält)*
+
+  * **Name**: ein Objekt, das alle Komponenten eines Personen-Namen enthält. *(Kontaktperson)*
+
+  * **Nickname**: einen lässig ein, um den Kontakt zu adressieren. *(DOM-String und enthält)*
+
+  * **Telefonnummern**: ein Array von der Kontakt-Telefonnummern. *(ContactField[])*
+
+  * **Email**: ein Array von e-Mail-Adressen des Kontakts. *(ContactField[])*
+
+  * **Adressen**: ein Array von allen Kontaktadressen. *(ContactAddress[])*
+
+  * **IMS**: ein Array von IM-Adressen des Kontakts. *(ContactField[])*
+
+  * **Organisationen**: ein Array von Organisationen des Kontakts. *(ContactOrganization[])*
+
+  * **Geburtstag**: der Geburtstag des Kontakts. *(Datum)*
+
+  * **Anmerkung**: eine Anmerkung über den Kontakt. *(DOM-String und enthält)*
+
+  * **Fotos**: ein Array mit den Kontakt-Fotos. *(ContactField[])*
+
+  * **Kategorien**: ein Array mit allen benutzerdefinierten Kategorien zugeordnet den Kontakt. *(ContactField[])*
+
+  * **URLs**: ein Array von Web-Seiten, die den Kontakt zugeordnet. *(ContactField[])*
+
+### Methoden
+
+  * **clone**: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
+
+  * **remove**: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem `ContactError` Objekt.
+
+  * **save**: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen **Id** bereits vorhanden ist.
+
+### Unterstützte Plattformen
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+  * Windows 8
+  * Windows
+
+### Speichern Sie Beispiel
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Clone-Beispiel
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Beispiel zu entfernen
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Android 2.X Macken
+
+  * **Kategorien**: Android 2.X Geräten, Rückgabe nicht unterstützt`null`.
+
+### BlackBerry 10 Macken
+
+  * **ID**: vom Gerät zugewiesen werden, wenn den Kontakt zu speichern.
+
+### FirefoxOS Macken
+
+  * **Kategorien**: teilweise unterstützt. Felder **Pref** und **Typ** kehren zurück`null`
+
+  * **IMS**: nicht unterstützt
+
+  * **Fotos**: nicht unterstützt
+
+### iOS Macken
+
+  * **DisplayName**: nicht auf iOS, Rückkehr unterstützt `null` es sei kein `ContactName` angegeben, in welchem Fall es gibt den zusammengesetzten Namen, **Spitznamen** oder `""` bzw..
+
+  * **Geburtstag**: muss eingegeben werden, als JavaScript `Date` Objekt, die gleiche Weise zurückgegeben wird.
+
+  * **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist. Inhalt des temporären Verzeichnisses werden entfernt, wenn die Anwendung beendet wird.
+
+  * **Kategorien**: Diese Eigenschaft wird derzeit nicht unterstützt, Rückgabe`null`.
+
+### Windows Phone 7 und 8 Eigenarten
+
+  * **DisplayName**: Wenn Sie einen Kontakt erstellen, der Nutzen für den Anzeigenamen der Display-Name-Parameter unterscheidet abgerufen, wenn den Kontakt zu finden.
+
+  * **URLs**: Wenn Sie einen Kontakt erstellen, können Benutzer eingegeben und mehrere Web-Adressen zu speichern, aber nur einer ist verfügbar, wenn Sie den Kontakt zu suchen.
+
+  * **Telefonnummern**: die *Pref* -Option wird nicht unterstützt. Der *Typ* wird in eine *find* -Operation nicht unterstützt. Nur ein `phoneNumber` ist erlaubt für jeden *Typ*.
+
+  * **Email**: *Pref* -Option wird nicht unterstützt. Haus und persönliche verweist auf dasselbe e-Mail-Eintrag. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+  * **Adressen**: unterstützt nur Arbeit und Home/persönliche *Art*. Den gleichen Adresseintrag auf den privaten und persönlichen *Typ* verweisen. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+  * **Organisationen**: nur zulässig ist, und unterstützt nicht die Attribute *Pref*, *Typ*und *Abteilung* .
+
+  * **Hinweis**: nicht unterstützt, Rückgabe`null`.
+
+  * **IMS**: nicht unterstützt, Rückgabe`null`.
+
+  * **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+  * **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+  * **remove**: Methode wird nicht unterstützt
+
+### Windows-Eigenheiten
+
+  * **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist.
+
+  * **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+  * **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+  * **remove**: Methode ist nur in Windows 10 oder höher unterstützt.
+
+## ContactAddress
+
+Das `ContactAddress`-Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. Ein `Contact` objekt kann mehr als eine Adresse in einem `ContactAddress []`-Array enthalten.
+
+### Eigenschaften
+
+  * **Pref**: Legen Sie auf `true` Wenn dieses `ContactAddress` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+  * **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+  * **formatiert**: die vollständige Adresse, die für die Anzeige formatiert. *(DOM-String und enthält)*
+
+  * **StreetAddress**: die vollständige Postanschrift. *(DOM-String und enthält)*
+
+  * **Ort**: die Stadt oder Gemeinde. *(DOM-String und enthält)*
+
+  * **Region**: dem Staat oder der Region. *(DOM-String und enthält)*
+
+  * **Postleitzahl**: die Postleitzahl oder Postleitzahl. *(DOM-String und enthält)*
+
+  * **Land**: den Ländernamen. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+  * Windows 8
+  * Windows
+
+### Beispiel
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X Macken
+
+  * **Pref**: nicht unterstützt, Rückkehr `false` auf Android 2.X Geräten.
+
+### BlackBerry 10 Macken
+
+  * **Pref**: BlackBerry-Geräten, Rückgabe nicht unterstützt`false`.
+
+  * **Typ**: teilweise unterstützt. Nur eine *Arbeit* und *Home* Typ Adressen kann pro Kontakt gespeichert werden.
+
+  * **formatiert**: teilweise unterstützt. Gibt eine Verkettung von allen BlackBerry-Adressfelder.
+
+  * **StreetAddress**: unterstützt. Gibt eine Verkettung von BlackBerry **Adresse1** und **Adresse2** Adressfelder.
+
+  * **Ort**: unterstützt. Gespeichert in BlackBerry **Stadt** Adressfeld.
+
+  * **Region**: unterstützt. Gespeichert in BlackBerry **StateProvince** Adressfeld.
+
+  * **Postleitzahl**: unterstützt. Im Feld für die Adresse des BlackBerry- **ZipPostal** gespeichert.
+
+  * **Land**: unterstützt.
+
+### FirefoxOS Macken
+
+  * **formatiert**: derzeit nicht unterstützt
+
+### iOS Macken
+
+  * **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+  * **formatiert**: derzeit nicht unterstützt.
+
+### Windows 8 Macken
+
+  * **Pref**: nicht unterstützt
+
+### Windows-Eigenheiten
+
+  * **Pref**: nicht unterstützt
+
+## ContactError
+
+Das `ContactError`-Objekt wird dem Benutzer über die `contactError`-Callback-Funktion zurückgegeben, wenn ein Fehler auftritt.
+
+### Eigenschaften
+
+  * **Code**: einer der vordefinierten Fehlercodes aufgeführt.
+
+### Konstanten
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Das `ContactField`-Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. Jedes `ContactField`-Objekt enthält eine Eigenschaft `value`, `type` und `pref`. Ein `Contact`-Objekt speichert mehrere Eigenschaften in `ContactField []`-Arrays, wie Telefonnummern und e-Mail-Adressen.
+
+In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `ContactField`-Objekt-**Type**-Attribut. Beispielsweise kann eine Telefonnummer angeben **type** werte von *home*, *work*, *mobile*, *iPhone* oder ein beliebiger anderer Wert, der von einem bestimmten Geräteplattform Kontaktdatenbank unterstützt wird. Jedoch für die `Contact`-**photos**-Feld, das **type**-Feld gibt das Format des zurückgegebenen Bild: **url** Wenn das **value**-Attribut eine URL zu dem Foto Bild oder *base64*, enthält Wenn der **Wert** eine base64-codierte Bild-Zeichenfolge enthält.
+
+### Eigenschaften
+
+  * **type**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+  * **value**: der Wert des Feldes, wie z. B. eine Telefonnummer oder e-Mail-Adresse. *(DOM-String und enthält)*
+
+  * **pref**: Legen Sie auf `true` Wenn dieses `ContactField` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+### Unterstützte Plattformen
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+  * Windows 8
+  * Windows
+
+### Beispiel
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Android Eigenarten
+
+  * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### BlackBerry 10 Macken
+
+  * **Typ**: teilweise unterstützt. Für Telefonnummern verwendet.
+
+  * **Wert**: unterstützt.
+
+  * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### iOS Macken
+
+  * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows8 Macken
+
+  * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows-Eigenheiten
+
+  * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+## ContactName
+
+Enthält verschiedene Arten von Informationen über `ein Kontaktobjekt` Namen.
+
+### Eigenschaften
+
+  * **formatiert**: den vollständigen Namen des Kontakts. *(DOM-String und enthält)*
+
+  * **Nachname**: Familienname des Kontakts. *(DOM-String und enthält)*
+
+  * **GivenName**: Given Name des Kontaktes. *(DOM-String und enthält)*
+
+  * **MiddleName**: Middle Name des Kontaktes. *(DOM-String und enthält)*
+
+  * **HonorificPrefix**: der Kontakt-Präfix (z.B. *Mr.* oder *Dr.*) *(DOM-String und enthält)*
+
+  * **HonorificSuffix**: der Kontakt-Suffix (Beispiel *Esq.*). *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+  * Windows 8
+  * Windows
+
+### Beispiel
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android Eigenarten
+
+  * **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### BlackBerry 10 Macken
+
+  * **formatiert**: teilweise unterstützt. Gibt eine Verkettung von BlackBerry- **FirstName** und **LastName** -Feldern.
+
+  * **Nachname**: unterstützt. Im Feld der BlackBerry- **Nachname** gespeichert.
+
+  * **GivenName**: unterstützt. Im BlackBerry **FirstName** -Feld gespeichert.
+
+  * **MiddleName**: nicht unterstützt, Rückgabe`null`.
+
+  * **HonorificPrefix**: nicht unterstützte, Rückgabe`null`.
+
+  * **HonorificSuffix**: nicht unterstützte, Rückgabe`null`.
+
+### FirefoxOS Macken
+
+  * **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### iOS Macken
+
+  * **formatiert**: teilweise unterstützt. IOS zusammengesetzten Namen gibt, aber ist schreibgeschützt.
+
+### Windows 8 Macken
+
+  * **formatiert**: Dies ist die einzige Eigenschaft, und ist identisch mit `displayName` , und`nickname`
+
+  * **Nachname**: nicht unterstützt
+
+  * **GivenName**: nicht unterstützt
+
+  * **MiddleName**: nicht unterstützt
+
+  * **HonorificPrefix**: nicht unterstützt
+
+  * **HonorificSuffix**: nicht unterstützt
+
+### Windows-Eigenheiten
+
+  * **formatiert**: Er ist identisch mit`displayName`
+
+## ContactOrganization
+
+Das `ContactOrganization`-Objekt speichert Organisationseigenschaften eines Kontakts. Ein `Contact` objekt werden ein oder mehrere `ContactOrganization`-Objekte in einem Array gespeichert.
+
+### Eigenschaften
+
+  * **Pref**: Legen Sie auf `true` Wenn dieses `ContactOrganization` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+  * **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. _(DOMString)
+
+  * **Name**: der Name der Organisation. *(DOM-String und enthält)*
+
+  * **Abteilung**: die Abteilung, die der Vertrag für arbeitet. *(DOM-String und enthält)*
+
+  * **Titel**: Titel des Kontakts in der Organisation. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 und 8
+  * Windows (nur Windows-8.1 und Windows Phone 8.1-Geräte)
+
+### Beispiel
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X Macken
+
+  * **Pref**: von Android 2.X-Geräte, Rückgabe nicht unterstützt`false`.
+
+### BlackBerry 10 Macken
+
+  * **Pref**: von BlackBerry-Geräten zurückgeben nicht unterstützt`false`.
+
+  * **Typ**: von BlackBerry-Geräten zurückgeben nicht unterstützt`null`.
+
+  * **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **Firma** BlackBerry gespeichert.
+
+  * **Abteilung**: nicht unterstützt, Rückgabe`null`.
+
+  * **Titel**: teilweise unterstützt. Der erste Titel der Organisation wird im Feld **JobTitle** BlackBerry gespeichert.
+
+### Firefox OS Macken
+
+  * **Pref**: nicht unterstützt
+
+  * **Typ**: nicht unterstützt
+
+  * **Abteilung**: nicht unterstützt
+
+  * Felder **Name** und **Titel** in **Org** und **JobTitle** gespeichert.
+
+### iOS Macken
+
+  * **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+  * **Typ**: iOS-Geräten, Rückgabe nicht unterstützt`null`.
+
+  * **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **kABPersonOrganizationProperty** iOS gespeichert.
+
+  * **Abteilung**: teilweise unterstützt. Die Abteilungsnamen der erste ist im Feld **kABPersonDepartmentProperty** iOS gespeichert.
+
+  * **Titel**: teilweise unterstützt. Der erste Titel wird im Feld **kABPersonJobTitleProperty** iOS gespeichert.
+
+### Windows-Eigenheiten
+
+  * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+  * **Typ**: nicht unterstützt, Rückgabe`null`.

km0App/node_modules/cordova-plugin-contacts/doc/de/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+Dieses Plugin definiert eine globale `navigator.contacts`-Objekt bietet Zugriff auf die Geräte-Kontakte-Datenbank.
+
+Obwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**Warnung**: Erhebung und Nutzung von Kontaktdaten löst wichtige Datenschutzprobleme. Ihre app-Datenschutzerklärung sollten besprechen, wie die app Kontaktdaten verwendet und ob es mit irgendwelchen anderen Parteien geteilt wird. Kontaktinformationen ist als vertraulich angesehen, weil es die Menschen zeigt, mit denen eine Person kommuniziert. Daher neben der app-Privacy Policy sollten stark Sie Bereitstellung eine just-in-Time-Bekanntmachung, bevor die app zugreift oder Kontaktdaten verwendet, wenn Betriebssystem des Geräts nicht dies bereits tun. Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das **OK** und **Nein danke**). Beachten Sie, dass einige app-Marktplätze die app eine Frist eine just-in-Time und erhalten die Erlaubnis des Benutzers vor dem Zugriff auf Kontaktdaten verlangen können. Eine klare und leicht verständliche Benutzererfahrung rund um die Verwendung der Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
+
+## Installation
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### Firefox OS Macken
+
+Erstellen Sie **www/manifest.webapp**, wie in [Docs Manifest][1] beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privileged" - [Manifest Docs][2] ändern. **Warnung**: alle privilegierten apps [Content Security Policy][3], welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows-Eigenheiten
+
+Keine Kontakte von `find` und `pickContact`-Methoden zurückgegebenen sind schreibgeschützt, so die Anwendung geändert werden kann. `find`-Methode nur auf Windows Phone 8.1-Geräten verfügbar.
+
+### Windows 8 Macken
+
+Windows 8 Kontakte sind Readonly. Über die Cordova-API-Kontakte nicht abgefragt werden/können durchsucht werden, Sie sollten den Benutzer informieren, wählen Sie einen Kontakt als Aufruf an contacts.pickContact, die 'People'-app öffnet, wo muss der Benutzer einen Kontakt auswählen. Alle zurückgegebenen Kontakte sind Readonly, so dass sie von die Anwendung nicht geändert werden kann.
+
+## Navigator.Contacts
+
+### Methoden
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Objekte
+
+*   Kontakt
+*   ContactName
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## Navigator.Contacts.Create
+
+Die `navigator.contacts.create`-Methode ist synchron und gibt ein neues `Contact` objekt.
+
+Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank, für die Sie benötigen, um die `Contact.save`-Methode aufzurufen.
+
+### Unterstützte Plattformen
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+
+### Beispiel
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Die `navigator.contacts.find`-Methode führt asynchron, Abfragen der Gerät-Kontakte-Datenbank und gibt ein Array von `Contact`-Objekte. Die resultierenden Objekte werden an die durch den **contactSuccess**-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.
+
+Der **contactFields**-Parameter gibt die Felder als Qualifizierer Suche verwendet werden. Ein leere **contactFields**-Parameter ist ungültig und führt zu `ContactError.INVALID_ARGUMENT_ERROR`. **contactFields** Wert `"*"` sucht alle Kontaktfelder.
+
+Die **contactFindOptions.filter**-Zeichenfolge kann als einen Suchfilter verwendet, wenn die Kontaktdatenbank Abfragen. Wenn angeboten, ein groß-und Kleinschreibung, wird jedes Feld in der **contactFields**-Parameter angegebenen Teilwert Übereinstimmung. Wenn eine Übereinstimmung für *alle* angegebenen Felder vorliegt, wird der Kontakt zurückgegeben. Verwendung **contactFindOptions.desiredFields** Parameter steuern, welche Eigenschaften kontaktieren muss wieder zurückgegeben werden.
+
+### Parameter
+
+*   **contactFields**: Kontaktfelder als Qualifizierer Suche verwenden. *(DOMString[])* [Required]
+
+*   **contactSuccess**: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Required]
+
+*   **contactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt.[Optional]
+
+*   **contactFindOptions**: Optionen zum Filtern von navigator.contacts zu suchen. [Optional]
+    
+    Schlüssel enthalten:
+    
+    *   **filter**: die zu suchende Zeichenfolge verwendet, um navigator.contacts zu finden. *(DOM-String und enthält)* (Standard: `""`)
+    
+    *   **multiple**: bestimmt, ob der Suchvorgang mehrere navigator.contacts gibt. *(Boolesch)* (Standard: `false`)
+        
+        *   **desiredFields**: Kontaktfelder wieder zurückgegeben werden. Wenn angegeben, Objekt der daraus resultierenden `Contact` nur Funktionen Werte für diese Felder. *(DOMString[])* [Optional]
+
+### Unterstützte Plattformen
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+*   Windows (nur Windows Phone 8.1-Geräte)
+
+### Beispiel
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows-Eigenheiten
+
+*   `__contactFields__`wird nicht unterstützt und wird ignoriert. `find`Methode wird immer versucht, die Namen, e-Mail-Adresse oder Telefonnummer eines Kontakts übereinstimmen.
+
+## navigator.contacts.pickContact
+
+Die `navigator.contacts.pickContact`-Methode startet im Kontakt Farbwähler wählen Sie einen einzigen Ansprechpartner. Das resultierende Objekt wird an die durch den **contactSuccess**-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.
+
+### Parameter
+
+*   **ContactSuccess**: Erfolg-Callback-Funktion, die mit den einzelnen Kontakt-Objekt aufgerufen. [Erforderlich]
+
+*   **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+
+### Unterstützte Plattformen
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### Beispiel
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Kontakt
+
+Das `Contact`-Objekt repräsentiert einen Benutzer Kontakt. Kontakte können erstellt, gespeichert oder aus der Gerät-Kontakte-Datenbank entfernt werden. Kontakte können auch (einzeln oder als Gruppe) aus der Datenbank abgerufen werden durch Aufrufen der `navigator.contacts.find`-Methode.
+
+**Hinweis**: nicht alle oben aufgeführten Kontaktfelder werden auf jedes Geräteplattform unterstützt. Bitte überprüfen Sie jede Plattform *Quirks* Abschnitt für Details.
+
+### Eigenschaften
+
+*   **ID**: einen globally unique Identifier. *(DOM-String und enthält)*
+
+*   **DisplayName**: der Name dieses Kontakts, geeignet für die Anzeige für Endbenutzer. *(DOM-String und enthält)*
+
+*   **Name**: ein Objekt, das alle Komponenten eines Personen-Namen enthält. *(Kontaktperson)*
+
+*   **Nickname**: einen lässig ein, um den Kontakt zu adressieren. *(DOM-String und enthält)*
+
+*   **Telefonnummern**: ein Array von der Kontakt-Telefonnummern. *(ContactField[])*
+
+*   **Email**: ein Array von e-Mail-Adressen des Kontakts. *(ContactField[])*
+
+*   **Adressen**: ein Array von allen Kontaktadressen. *(ContactAddress[])*
+
+*   **IMS**: ein Array von IM-Adressen des Kontakts. *(ContactField[])*
+
+*   **Organisationen**: ein Array von Organisationen des Kontakts. *(ContactOrganization[])*
+
+*   **Geburtstag**: der Geburtstag des Kontakts. *(Datum)*
+
+*   **Anmerkung**: eine Anmerkung über den Kontakt. *(DOM-String und enthält)*
+
+*   **Fotos**: ein Array mit den Kontakt-Fotos. *(ContactField[])*
+
+*   **Kategorien**: ein Array mit allen benutzerdefinierten Kategorien zugeordnet den Kontakt. *(ContactField[])*
+
+*   **URLs**: ein Array von Web-Seiten, die den Kontakt zugeordnet. *(ContactField[])*
+
+### Methoden
+
+*   **clone**: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
+
+*   **remove**: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem `ContactError` Objekt.
+
+*   **save**: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen **Id** bereits vorhanden ist.
+
+### Unterstützte Plattformen
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+*   Windows 8
+*   Windows
+
+### Speichern Sie Beispiel
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Clone-Beispiel
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Beispiel zu entfernen
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Android 2.X Macken
+
+*   **Kategorien**: Android 2.X Geräten, Rückgabe nicht unterstützt`null`.
+
+### BlackBerry 10 Macken
+
+*   **ID**: vom Gerät zugewiesen werden, wenn den Kontakt zu speichern.
+
+### FirefoxOS Macken
+
+*   **Kategorien**: teilweise unterstützt. Felder **Pref** und **Typ** kehren zurück`null`
+
+*   **IMS**: nicht unterstützt
+
+*   **Fotos**: nicht unterstützt
+
+### iOS Macken
+
+*   **DisplayName**: nicht auf iOS, Rückkehr unterstützt `null` es sei kein `ContactName` angegeben, in welchem Fall es gibt den zusammengesetzten Namen, **Spitznamen** oder `""` bzw..
+
+*   **Geburtstag**: muss eingegeben werden, als JavaScript `Date` Objekt, die gleiche Weise zurückgegeben wird.
+
+*   **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist. Inhalt des temporären Verzeichnisses werden entfernt, wenn die Anwendung beendet wird.
+
+*   **Kategorien**: Diese Eigenschaft wird derzeit nicht unterstützt, Rückgabe`null`.
+
+### Windows Phone 7 und 8 Eigenarten
+
+*   **DisplayName**: Wenn Sie einen Kontakt erstellen, der Nutzen für den Anzeigenamen der Display-Name-Parameter unterscheidet abgerufen, wenn den Kontakt zu finden.
+
+*   **URLs**: Wenn Sie einen Kontakt erstellen, können Benutzer eingegeben und mehrere Web-Adressen zu speichern, aber nur einer ist verfügbar, wenn Sie den Kontakt zu suchen.
+
+*   **Telefonnummern**: die *Pref* -Option wird nicht unterstützt. Der *Typ* wird in eine *find* -Operation nicht unterstützt. Nur ein `phoneNumber` ist erlaubt für jeden *Typ*.
+
+*   **Email**: *Pref* -Option wird nicht unterstützt. Haus und persönliche verweist auf dasselbe e-Mail-Eintrag. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+*   **Adressen**: unterstützt nur Arbeit und Home/persönliche *Art*. Den gleichen Adresseintrag auf den privaten und persönlichen *Typ* verweisen. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+*   **Organisationen**: nur zulässig ist, und unterstützt nicht die Attribute *Pref*, *Typ*und *Abteilung* .
+
+*   **Hinweis**: nicht unterstützt, Rückgabe`null`.
+
+*   **IMS**: nicht unterstützt, Rückgabe`null`.
+
+*   **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+*   **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+### Windows-Eigenheiten
+
+*   **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist.
+
+*   **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+*   **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+## ContactAddress
+
+Das `ContactAddress`-Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. Ein `Contact` objekt kann mehr als eine Adresse in einem `ContactAddress []`-Array enthalten.
+
+### Eigenschaften
+
+*   **Pref**: Legen Sie auf `true` Wenn dieses `ContactAddress` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+*   **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+*   **formatiert**: die vollständige Adresse, die für die Anzeige formatiert. *(DOM-String und enthält)*
+
+*   **StreetAddress**: die vollständige Postanschrift. *(DOM-String und enthält)*
+
+*   **Ort**: die Stadt oder Gemeinde. *(DOM-String und enthält)*
+
+*   **Region**: dem Staat oder der Region. *(DOM-String und enthält)*
+
+*   **Postleitzahl**: die Postleitzahl oder Postleitzahl. *(DOM-String und enthält)*
+
+*   **Land**: den Ländernamen. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+*   Windows 8
+*   Windows
+
+### Beispiel
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X Macken
+
+*   **Pref**: nicht unterstützt, Rückkehr `false` auf Android 2.X Geräten.
+
+### BlackBerry 10 Macken
+
+*   **Pref**: BlackBerry-Geräten, Rückgabe nicht unterstützt`false`.
+
+*   **Typ**: teilweise unterstützt. Nur eine *Arbeit* und *Home* Typ Adressen kann pro Kontakt gespeichert werden.
+
+*   **formatiert**: teilweise unterstützt. Gibt eine Verkettung von allen BlackBerry-Adressfelder.
+
+*   **StreetAddress**: unterstützt. Gibt eine Verkettung von BlackBerry **Adresse1** und **Adresse2** Adressfelder.
+
+*   **Ort**: unterstützt. Gespeichert in BlackBerry **Stadt** Adressfeld.
+
+*   **Region**: unterstützt. Gespeichert in BlackBerry **StateProvince** Adressfeld.
+
+*   **Postleitzahl**: unterstützt. Im Feld für die Adresse des BlackBerry- **ZipPostal** gespeichert.
+
+*   **Land**: unterstützt.
+
+### FirefoxOS Macken
+
+*   **formatiert**: derzeit nicht unterstützt
+
+### iOS Macken
+
+*   **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+*   **formatiert**: derzeit nicht unterstützt.
+
+### Windows 8 Macken
+
+*   **Pref**: nicht unterstützt
+
+### Windows-Eigenheiten
+
+*   **Pref**: nicht unterstützt
+
+## ContactError
+
+Das `ContactError`-Objekt wird dem Benutzer über die `contactError`-Callback-Funktion zurückgegeben, wenn ein Fehler auftritt.
+
+### Eigenschaften
+
+*   **Code**: einer der vordefinierten Fehlercodes aufgeführt.
+
+### Konstanten
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Das `ContactField`-Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. Jedes `ContactField`-Objekt enthält eine Eigenschaft `value`, `type` und `pref`. Ein `Contact`-Objekt speichert mehrere Eigenschaften in `ContactField []`-Arrays, wie Telefonnummern und e-Mail-Adressen.
+
+In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `ContactField`-Objekt-**Type**-Attribut. Beispielsweise kann eine Telefonnummer angeben **type** werte von *home*, *work*, *mobile*, *iPhone* oder ein beliebiger anderer Wert, der von einem bestimmten Geräteplattform Kontaktdatenbank unterstützt wird. Jedoch für die `Contact`-**photos**-Feld, das **type**-Feld gibt das Format des zurückgegebenen Bild: **url** Wenn das **value**-Attribut eine URL zu dem Foto Bild oder *base64*, enthält Wenn der **Wert** eine base64-codierte Bild-Zeichenfolge enthält.
+
+### Eigenschaften
+
+*   **type**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+*   **value**: der Wert des Feldes, wie z. B. eine Telefonnummer oder e-Mail-Adresse. *(DOM-String und enthält)*
+
+*   **pref**: Legen Sie auf `true` Wenn dieses `ContactField` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+### Unterstützte Plattformen
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+*   Windows 8
+*   Windows
+
+### Beispiel
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Android Eigenarten
+
+*   **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### BlackBerry 10 Macken
+
+*   **Typ**: teilweise unterstützt. Für Telefonnummern verwendet.
+
+*   **Wert**: unterstützt.
+
+*   **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### iOS Macken
+
+*   **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows8 Macken
+
+*   **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows-Eigenheiten
+
+*   **Pref**: nicht unterstützt, Rückgabe`false`.
+
+## ContactName
+
+Enthält verschiedene Arten von Informationen über `ein Kontaktobjekt` Namen.
+
+### Eigenschaften
+
+*   **formatiert**: den vollständigen Namen des Kontakts. *(DOM-String und enthält)*
+
+*   **Nachname**: Familienname des Kontakts. *(DOM-String und enthält)*
+
+*   **GivenName**: Given Name des Kontaktes. *(DOM-String und enthält)*
+
+*   **MiddleName**: Middle Name des Kontaktes. *(DOM-String und enthält)*
+
+*   **HonorificPrefix**: der Kontakt-Präfix (z.B. *Mr.* oder *Dr.*) *(DOM-String und enthält)*
+
+*   **HonorificSuffix**: der Kontakt-Suffix (Beispiel *Esq.*). *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+*   Windows 8
+*   Windows
+
+### Beispiel
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android Eigenarten
+
+*   **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### BlackBerry 10 Macken
+
+*   **formatiert**: teilweise unterstützt. Gibt eine Verkettung von BlackBerry- **FirstName** und **LastName** -Feldern.
+
+*   **Nachname**: unterstützt. Im Feld der BlackBerry- **Nachname** gespeichert.
+
+*   **GivenName**: unterstützt. Im BlackBerry **FirstName** -Feld gespeichert.
+
+*   **MiddleName**: nicht unterstützt, Rückgabe`null`.
+
+*   **HonorificPrefix**: nicht unterstützte, Rückgabe`null`.
+
+*   **HonorificSuffix**: nicht unterstützte, Rückgabe`null`.
+
+### FirefoxOS Macken
+
+*   **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### iOS Macken
+
+*   **formatiert**: teilweise unterstützt. IOS zusammengesetzten Namen gibt, aber ist schreibgeschützt.
+
+### Windows 8 Macken
+
+*   **formatiert**: Dies ist die einzige Eigenschaft, und ist identisch mit `displayName` , und`nickname`
+
+*   **Nachname**: nicht unterstützt
+
+*   **GivenName**: nicht unterstützt
+
+*   **MiddleName**: nicht unterstützt
+
+*   **HonorificPrefix**: nicht unterstützt
+
+*   **HonorificSuffix**: nicht unterstützt
+
+### Windows-Eigenheiten
+
+*   **formatiert**: Er ist identisch mit`displayName`
+
+## ContactOrganization
+
+Das `ContactOrganization`-Objekt speichert Organisationseigenschaften eines Kontakts. Ein `Contact` objekt werden ein oder mehrere `ContactOrganization`-Objekte in einem Array gespeichert.
+
+### Eigenschaften
+
+*   **Pref**: Legen Sie auf `true` Wenn dieses `ContactOrganization` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+*   **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. _(DOMString)
+
+*   **Name**: der Name der Organisation. *(DOM-String und enthält)*
+
+*   **Abteilung**: die Abteilung, die der Vertrag für arbeitet. *(DOM-String und enthält)*
+
+*   **Titel**: Titel des Kontakts in der Organisation. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 und 8
+*   Windows (nur Windows-8.1 und Windows Phone 8.1-Geräte)
+
+### Beispiel
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X Macken
+
+*   **Pref**: von Android 2.X-Geräte, Rückgabe nicht unterstützt`false`.
+
+### BlackBerry 10 Macken
+
+*   **Pref**: von BlackBerry-Geräten zurückgeben nicht unterstützt`false`.
+
+*   **Typ**: von BlackBerry-Geräten zurückgeben nicht unterstützt`null`.
+
+*   **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **Firma** BlackBerry gespeichert.
+
+*   **Abteilung**: nicht unterstützt, Rückgabe`null`.
+
+*   **Titel**: teilweise unterstützt. Der erste Titel der Organisation wird im Feld **JobTitle** BlackBerry gespeichert.
+
+### Firefox OS Macken
+
+*   **Pref**: nicht unterstützt
+
+*   **Typ**: nicht unterstützt
+
+*   **Abteilung**: nicht unterstützt
+
+*   Felder **Name** und **Titel** in **Org** und **JobTitle** gespeichert.
+
+### iOS Macken
+
+*   **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+*   **Typ**: iOS-Geräten, Rückgabe nicht unterstützt`null`.
+
+*   **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **kABPersonOrganizationProperty** iOS gespeichert.
+
+*   **Abteilung**: teilweise unterstützt. Die Abteilungsnamen der erste ist im Feld **kABPersonDepartmentProperty** iOS gespeichert.
+
+*   **Titel**: teilweise unterstützt. Der erste Titel wird im Feld **kABPersonJobTitleProperty** iOS gespeichert.
+
+### Windows-Eigenheiten
+
+*   **Pref**: nicht unterstützt, Rückgabe`false`.
+
+*   **Typ**: nicht unterstützt, Rückgabe`null`.

km0App/node_modules/cordova-plugin-contacts/doc/es/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Este plugin define un global `navigator.contacts` objeto que proporciona acceso a la base de datos de contactos de dispositivo.
+
+Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**ADVERTENCIA**: recopilación y uso de datos plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza datos de contacto y si es compartida con terceros. Información de contacto se considera sensible porque revela la gente con quien se comunica una persona. Por lo tanto, además de política de privacidad de la app, fuertemente considere dar un aviso de just-in-time antes de la aplicación accede a ellos o utiliza los datos de contacto, si el sistema operativo del dispositivo no hacerlo ya. Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para **Aceptar** y **No gracias**). Tenga en cuenta que algunos mercados de aplicación podrán exigir la aplicación para proporcionar un aviso de just-in-time y obtener el permiso del usuario antes de acceder a datos de contacto. Una experiencia de usuario clara y fácil de entender que rodean el uso de contacto datos ayuda a evitar la confusión del usuario y percibe uso indebido de los datos de contacto. Para obtener más información, por favor consulte a la guía de privacidad.
+
+## Instalación
+
+Esto requiere cordova 5.0 + (v1.0.0 estable actual)
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+Las versiones más antiguas de Córdoba todavía pueden instalar mediante el id de **obsoleto** (viejo v0.2.16)
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+También es posible instalar directamente vía url repo (inestable)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### Firefox OS rarezas
+
+Crear **www/manifest.webapp** como se describe en [Manifestar Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest). Agregar permisos pertinentes. También hay una necesidad de cambiar el tipo de aplicación a "privilegiados" - [Docs manifiestan](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type). **ADVERTENCIA**: todas las apps privilegiadas aplicar [Política de seguridad de contenidos](https://developer.mozilla.org/en-US/Apps/CSP) que prohíbe en línea de comandos. Inicializar la aplicación de otra manera.
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows rarezas
+
+**Antes de Windows 10:** Contactos `encontrar` y `pickContact` métodos son sólo lectura, por lo que su aplicación no puede modificarlos. método `Find` disponible sólo en dispositivos Windows Phone 8.1.
+
+**Windows 10 y anteriores:** Contactos se pueden guardar y se guarda en almacenamiento local de la aplicación contactos. Contactos también pueden ser eliminados.
+
+### Rarezas de Windows 8
+
+Windows 8 contactos son de sólo lectura. Través de los contactos de la API de Córdoba no son consultables/búsqueda, se debe informar al usuario a buscar un contacto como una llamada a contacts.pickContact que se abrirá la aplicación 'Personas' donde el usuario debe elegir un contacto. Cualquier contacto volvió es readonly, su aplicación no puede modificarlos.
+
+## Navigator.Contacts
+
+### Métodos
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### Objetos
+
+  * Contact
+  * ContactName
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+El `navigator.contacts.create` método es sincrónico y devuelve una nueva `Contact` objeto.
+
+Este método no retiene el objeto de contacto en la base de contactos de dispositivo, para lo cual necesita invocar el `Contact.save` método.
+
+### Plataformas soportadas
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+
+### Ejemplo
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+El `navigator.contacts.find` método se ejecuta asincrónicamente, consultando la base de datos de contactos de dispositivo y devolver una matriz de `Contact` objetos. Los objetos resultantes son pasados a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda. Un parámetro de longitud cero **contactFields** no es válido y resultados en `ContactError.INVALID_ARGUMENT_ERROR` . Un valor de **contactFields** de `"*"` busca campos todo contactos.
+
+La cadena de **contactFindOptions.filter** puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, una entre mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields** . Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto. Uso **contactFindOptions.desiredFields** parámetro al control que Contacta con propiedades debe devolverse atrás.
+
+### Parámetros
+
+  * **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. *(DOMString[])* [Required]
+
+  * **contactSuccess**: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Required]
+
+  * **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+
+  * **contactFindOptions**: buscar opciones para filtrar navigator.contacts. [Optional]
+    
+    Claves incluyen:
+    
+      * **filtro**: la cadena de búsqueda utilizada para encontrar navigator.contacts. *(DOMString)* (Por defecto:`""`)
+    
+      * **múltiples**: determina si la operación de búsqueda devuelve múltiples navigator.contacts. *(Booleano)* (Por defecto:`false`)
+        
+          * **desiredFields**: póngase en contacto con campos para volver atrás. Si se especifica, la resultante `Contact` objeto sólo cuenta con los valores de estos campos. *(DOMString[])* [Optional]
+
+### Plataformas soportadas
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+  * Windows (Windows Phone 8.1 y Windows 10)
+
+### Ejemplo
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows rarezas
+
+  * `__contactFields__`No se admite y se ignorará. `find`método siempre tratará de coincidir con el nombre, dirección de correo electrónico o número de teléfono de un contacto.
+
+## navigator.contacts.pickContact
+
+El `navigator.contacts.pickContact` método lanza el selector para seleccionar un único contacto contacto. El objeto resultante se pasa a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+### Parámetros
+
+  * **contactSuccess**: función de callback de éxito se invoca con el único objeto de contacto. [Obligatorio]
+
+  * **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+
+### Plataformas soportadas
+
+  * Android
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### Ejemplo
+
+    navigator.contacts.pickContact(function(contact) {console.log (' se ha seleccionado el siguiente contacto: "+ JSON.stringify(contact));
+        }, function(err) {console.log ('Error: ' + err);
+        });
+    
+
+## Contact
+
+El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser creados, almacenados o eliminados de la base de datos de contactos de dispositivo. Contactos pueden también ser obtenidos (individualmente o a granel) de la base de datos invocando el `navigator.contacts.find` método.
+
+**Nota**: no todos los campos de contacto mencionados son compatibles con la plataforma de cada dispositivo. Consulte sección *peculiaridades* de cada plataforma para más detalles.
+
+### Propiedades
+
+  * **ID**: un identificador único global. *(DOMString)*
+
+  * **displayName**: el nombre de este contacto, conveniente para la exhibición a los usuarios finales. *(DOMString)*
+
+  * **nombre**: un objeto que contiene todos los componentes de un nombre de las personas. *(ContactName)*
+
+  * **apodo**: un nombre para abordar el contacto casual. *(DOMString)*
+
+  * **números**: una matriz de números de teléfono de contacto. *(ContactField[])*
+
+  * **correos electrónicos**: un conjunto de direcciones de correo electrónico del contacto. *(ContactField[])*
+
+  * **direcciones**: un conjunto de direcciones de todos los contactos. *(ContactAddress[])*
+
+  * **IMS**: un conjunto de direcciones de todos los contactos IM. *(ContactField[])*
+
+  * **organizaciones**: un conjunto de organizaciones de todos los contactos. *(ContactOrganization[])*
+
+  * **cumpleaños**: el cumpleaños del contacto. *(Fecha)*
+
+  * **Nota**: una nota sobre el contacto. *(DOMString)*
+
+  * **fotos**: una serie de fotos de los contactos. *(ContactField[])*
+
+  * **categorías**: una matriz de todas las categorías definidas por el usuario asociado con el contacto. *(ContactField[])*
+
+  * **URL**: un conjunto de páginas web asociadas con el contacto. *(ContactField[])*
+
+### Métodos
+
+  * **clon**: devuelve un nuevo `Contact` objeto que es una copia en profundidad del objeto de llamadas con el `id` propiedad establecida en`null`.
+
+  * **eliminar**: elimina el contacto de la base de datos de contactos de dispositivo, si no se ejecuta un callback de error con un `ContactError` objeto.
+
+  * **Guardar**: guarda un nuevo contacto en la base de datos de contactos de dispositivo o actualiza un contacto existente si ya existe un contacto con el mismo **id** .
+
+### Plataformas soportadas
+
+  * Amazon fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+  * Windows 8
+  * Windows
+
+### Salvar ejemplo
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Ejemplo de clon
+
+        clon del clon de contacto objeto var = contact.clone();
+        clone.name.givenName = "John";
+        Console.log ("contacto Original nombre =" + contact.name.givenName);
+        Console.log ("Cloned contacto nombre =" + clone.name.givenName);
+    
+
+### Quitar ejemplo
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Rarezas Android 2.X
+
+  * **categories**: no compatible con dispositivos Android 2.X, devolver `null`.
+
+### BlackBerry 10 rarezas
+
+  * **ID**: asignado por el dispositivo cuando se guarda el contacto.
+
+### FirefoxOS rarezas
+
+  * **categorías**: parcialmente soportado. Campos **pref** y **tipo** regresan`null`
+
+  * **IMS**: no se admite
+
+  * **fotos**: no se admite
+
+### iOS rarezas
+
+  * **displayName**: no compatible con iOS, regresando `null` si no hay ningún `ContactName` especifica, en cuyo caso devuelve el nombre del compuesto, **apodo** o `""` , respectivamente.
+
+  * **cumpleaños**: debe ser de entrada como un JavaScript `Date` objeto, del mismo modo que se la devuelvan.
+
+  * **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación. Contenidos del directorio temporal se eliminan cuando salga de la aplicación.
+
+  * **categorías**: esta propiedad actualmente no es compatible, regresando`null`.
+
+### Windows Phone 7 y 8 rarezas
+
+  * **displayName**: cuando se crea un contacto, previsto para el parámetro de nombre pantalla difiere el nombre para mostrar el valor obtenido al encontrar el contacto.
+
+  * **URL**: cuando se crea un contacto, los usuarios pueden ingresar y salvar más de una dirección web, pero sólo está disponible cuando busque el contacto.
+
+  * **números**: no se admite la opción *pref* . El *tipo* no se admite en una operación de *encontrar* . Solamente un `phoneNumber` está permitido para cada *tipo*.
+
+  * **correos electrónicos**: no se admite la opción *pref* . Home y referencias misma entrada de correo electrónico. Se permite solamente una entrada para cada *tipo*.
+
+  * **direcciones**: soporta sólo trabajo y hogar/personal *tipo*. La casa y personales de *tipo* referencia la misma entrada de dirección. Se permite solamente una entrada para cada *tipo*.
+
+  * **organizaciones**: sólo está permitido y no es compatible con los atributos *pref*, *tipo*y *Departamento* .
+
+  * **Nota**: no compatible, regresando`null`.
+
+  * **ims**: no soportado, devolver `null`.
+
+  * **cumpleaños**: no soportado, regresando`null`.
+
+  * **categorías**: no soportado, regresando`null`.
+
+  * **remove**: no se admite el método
+
+### Windows rarezas
+
+  * **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación.
+
+  * **cumpleaños**: no soportado, regresando`null`.
+
+  * **categorías**: no soportado, regresando`null`.
+
+  * **remove**: el método sólo es soportado en Windows 10 o superior.
+
+## ContactAddress
+
+El `ContactAddress` objeto almacena las propiedades de una única dirección de un contacto. A `Contact` objeto puede incluir más de una dirección en un `ContactAddress[]` matriz.
+
+### Propiedades
+
+  * **pref**: establecido en `true` si esta `ContactAddress` contiene el usuario preferido de valor. *(boolean)*
+
+  * **type**: una cadena que indica qué tipo de campo es, *home* por ejemplo. *(DOMString)*
+
+  * **formatted**: la dirección completa con formato de visualización. *(DOMString)*
+
+  * **streetAddress**: la dirección completa. *(DOMString)*
+
+  * **locality**: la ciudad o localidad. *(DOMString)*
+
+  * **region**: el estado o la región. *(DOMString)*
+
+  * **postalCode**: el código postal o código postal. *(DOMString)*
+
+  * **country**: el nombre del país. *(DOMString)*
+
+### Plataformas soportadas
+
+  * Amazon fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+  * Windows 8
+  * Windows
+
+### Ejemplo
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Rarezas Android 2.X
+
+  * **pref**: no soportado, devolviendo `false` en dispositivos Android 2.X.
+
+### BlackBerry 10 rarezas
+
+  * **pref**: no compatible con dispositivos BlackBerry, devolviendo `false`.
+
+  * **type**: parcialmente soportado. Sólo uno de cada *Work* y *Home* tipo direcciones puede ser almacenado por contacto.
+
+  * **formatted**: parcialmente soportado. Devuelve una concatenación de todos los campos de dirección de BlackBerry.
+
+  * **streetAddress**: soportado. Devuelve una concatenación de BlackBerry **address1** y **2** campos de dirección.
+
+  * **locality**: apoyado. Almacenada en el campo de dirección de la **city** de BlackBerry.
+
+  * **region**: apoyado. Almacenada en el campo de dirección de BlackBerry **stateProvince**.
+
+  * **postalCode**: apoyado. Almacenada en el campo de dirección de BlackBerry **zipPostal**.
+
+  * **country**: apoyado.
+
+### FirefoxOS rarezas
+
+  * **formato**: actualmente no se admite
+
+### iOS rarezas
+
+  * **pref**: no se admite en dispositivos iOS, devolviendo `false`.
+
+  * **formatted**: actualmente no se admite.
+
+### Rarezas de Windows 8
+
+  * **Pref**: no se admite
+
+### Windows rarezas
+
+  * **Pref**: no se admite
+
+## ContactError
+
+El `ContactError` objeto se devuelve al usuario a través de la `contactError` función de devolución de llamada cuando se produce un error.
+
+### Propiedades
+
+  * **code**: uno de los códigos de error predefinido enumerados a continuación.
+
+### Constantes
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+El `ContactField` objeto es un componente reutilizable que representa en contacto con campos genéricamente. Cada `ContactField` objeto contiene un `value` , `type` , y `pref` propiedad. A `Contact` objeto almacena varias propiedades en `ContactField[]` arreglos de discos, como las direcciones de teléfono números y correo electrónico.
+
+En la mayoría de los casos, no existen previamente determinados valores para un `ContactField` atributo **type** del objeto. Por ejemplo, un número de teléfono puede especificar valores de **tipo** de *hogar*, *trabajo*, *móvil*, *iPhone*o cualquier otro valor que es apoyado por contacto de base de datos de una plataforma dispositivo determinado. Sin embargo, para el `Contact` **fotos de** campo, el campo **tipo** indica el formato de la imagen devuelta: **url** cuando el atributo de **valor** contiene una dirección URL de la imagen de la foto, o *base64* cuando el **valor** contiene una cadena codificada en base64 imagen.
+
+### Propiedades
+
+  * **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. *(DOMString)*
+
+  * **valor**: el valor del campo, como un teléfono número o dirección de email. *(DOMString)*
+
+  * **Pref**: A `true` si este `ContactField` contiene el valor del usuario preferido. *(booleano)*
+
+### Plataformas soportadas
+
+  * Amazon fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+  * Windows 8
+  * Windows
+
+### Ejemplo
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Rarezas Android
+
+  * **Pref**: no soportado, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+  * **tipo**: parcialmente soportado. Utilizado para los números de teléfono.
+
+  * **valor**: apoyado.
+
+  * **Pref**: no soportado, regresando`false`.
+
+### iOS rarezas
+
+  * **Pref**: no soportado, regresando`false`.
+
+### Windows8 rarezas
+
+  * **Pref**: no soportado, regresando`false`.
+
+### Windows rarezas
+
+  * **Pref**: no soportado, regresando`false`.
+
+## ContactName
+
+Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
+
+### Propiedades
+
+  * **formato**: el nombre completo del contacto. *(DOMString)*
+
+  * **familia**: el nombre del contacto familiar. *(DOMString)*
+
+  * **givenName**: nombre del contacto. *(DOMString)*
+
+  * **middleName**: el nombre del contacto media. *(DOMString)*
+
+  * **honorificPrefix**: prefijo del contacto (ejemplo *señor* o *doctor*) *(DOMString)*
+
+  * **honorificSuffix**: sufijo de contacto (ejemplo *Esq.*). *(DOMString)*
+
+### Plataformas soportadas
+
+  * Amazon fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+  * Windows 8
+  * Windows
+
+### Ejemplo
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Rarezas Android
+
+  * **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### BlackBerry 10 rarezas
+
+  * **formato**: parcialmente soportado. Devuelve una concatenación de campos **firstName** y **lastName** de BlackBerry.
+
+  * **familia**: apoyo. Almacenada en el campo **lastName** BlackBerry.
+
+  * **givenName**: apoyado. Almacenados en campo **firstName** BlackBerry.
+
+  * **middleName**: no soportado, regresando`null`.
+
+  * **honorificPrefix**: no soportado, regresando`null`.
+
+  * **honorificSuffix**: no soportado, regresando`null`.
+
+### FirefoxOS rarezas
+
+  * **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### iOS rarezas
+
+  * **formato**: parcialmente soportado. Devuelve iOS nombre compuesto, pero es de sólo lectura.
+
+### Rarezas de Windows 8
+
+  * **formato**: este es el único nombre de propiedad y es idéntico al `displayName` , y`nickname`
+
+  * **familia**: no se admite
+
+  * **givenName**: no se admite
+
+  * **middleName**: no se admite
+
+  * **honorificPrefix**: no se admite
+
+  * **honorificSuffix**: no se admite
+
+### Windows rarezas
+
+  * **formato**: es idéntica a`displayName`
+
+## ContactOrganization
+
+El `ContactOrganization` objeto almacena las propiedades de organización de un contacto. A `Contact` objeto almacena uno o más `ContactOrganization` los objetos en una matriz.
+
+### Propiedades
+
+  * **Pref**: A `true` si este `ContactOrganization` contiene el valor del usuario preferido. *(booleano)*
+
+  * **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. _(DOMString)
+
+  * **nombre**: el nombre de la organización. *(DOMString)*
+
+  * **Departamento**: el contrato de obras para el departamento. *(DOMString)*
+
+  * **título**: título del contacto de la organización. *(DOMString)*
+
+### Plataformas soportadas
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 y 8
+  * Windows (sólo dispositivos Windows 8.1 y 8.1 de Windows Phone)
+
+### Ejemplo
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Rarezas Android 2.X
+
+  * **Pref**: no compatible con dispositivos Android 2.X, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+  * **Pref**: no compatible con dispositivos BlackBerry, regresando`false`.
+
+  * **tipo**: no compatible con dispositivos BlackBerry, regresando`null`.
+
+  * **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de la **empresa** BlackBerry.
+
+  * **Departamento**: no soportado, regresando`null`.
+
+  * **título**: parcialmente soportado. El primer título de la organización se almacena en el campo de **jobTitle** BlackBerry.
+
+### Firefox OS rarezas
+
+  * **Pref**: no se admite
+
+  * **tipo**: no se admite
+
+  * **Departamento**: no se admite
+
+  * Los campos **nombre** y **título** almacenado en **org** y **jobTitle**.
+
+### iOS rarezas
+
+  * **pref**: no se admite en dispositivos iOS, devolviendo `false`.
+
+  * **tipo**: no se admite en dispositivos iOS, regresando`null`.
+
+  * **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de **kABPersonOrganizationProperty** de iOS.
+
+  * **Departamento**: parcialmente soportado. El primer nombre de departamento se almacena en el campo de **kABPersonDepartmentProperty** de iOS.
+
+  * **título**: parcialmente soportado. El primer título se almacena en el campo de **kABPersonJobTitleProperty** de iOS.
+
+### Windows rarezas
+
+  * **Pref**: no soportado, regresando`false`.
+
+  * **tipo**: no soportado, regresando`null`.

km0App/node_modules/cordova-plugin-contacts/doc/es/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+Este plugin define un global `navigator.contacts` objeto que proporciona acceso a la base de datos de contactos de dispositivo.
+
+Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.
+
+    document.addEventListener ("deviceready", onDeviceReady, false);
+    function onDeviceReady() {console.log(navigator.contacts)};
+    
+
+**ADVERTENCIA**: recopilación y uso de datos plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza datos de contacto y si es compartida con terceros. Información de contacto se considera sensible porque revela la gente con quien se comunica una persona. Por lo tanto, además de política de privacidad de la app, fuertemente considere dar un aviso de just-in-time antes de la aplicación accede a ellos o utiliza los datos de contacto, si el sistema operativo del dispositivo no hacerlo ya. Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para **Aceptar** y **No gracias**). Tenga en cuenta que algunos mercados de aplicación podrán exigir la aplicación para proporcionar un aviso de just-in-time y obtener el permiso del usuario antes de acceder a datos de contacto. Una experiencia de usuario clara y fácil de entender que rodean el uso de contacto datos ayuda a evitar la confusión del usuario y percibe uso indebido de los datos de contacto. Para obtener más información, por favor consulte a la guía de privacidad.
+
+## Instalación
+
+    Cordova plugin agregar cordova-plugin-contacts
+    
+
+### Firefox OS rarezas
+
+Crear **www/manifest.webapp** como se describe en [Manifestar Docs][1]. Agregar permisos pertinentes. También hay una necesidad de cambiar el tipo de aplicación a "privilegiados" - [Docs manifiestan][2]. **ADVERTENCIA**: todas las apps privilegiadas aplicar [Política de seguridad de contenidos][3] que prohíbe en línea de comandos. Inicializar la aplicación de otra manera.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "tipo": "el privilegio", "permisos": {"contactos": {"acceso": "readwrite", "Descripción": "describir por qué hay una necesidad de tal autorización"}}
+    
+
+### Windows rarezas
+
+Cualquier contacto regresado de `find` y `pickContact` métodos son readonly, por lo que su aplicación no puede modificarlos. `find`método disponible sólo en dispositivos Windows Phone 8.1.
+
+### Rarezas de Windows 8
+
+Windows 8 contactos son de sólo lectura. Través de los contactos de la API de Córdoba no son consultables/búsqueda, se debe informar al usuario a buscar un contacto como una llamada a contacts.pickContact que se abrirá la aplicación 'Personas' donde el usuario debe elegir un contacto. Cualquier contacto volvió es readonly, su aplicación no puede modificarlos.
+
+## Navigator.Contacts
+
+### Métodos
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Objetos
+
+*   Contact
+*   ContactName
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## Navigator.contacts.Create
+
+El `navigator.contacts.create` método es sincrónico y devuelve una nueva `Contact` objeto.
+
+Este método no retiene el objeto de contacto en la base de contactos de dispositivo, para lo cual necesita invocar el `Contact.save` método.
+
+### Plataformas soportadas
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+
+### Ejemplo
+
+    var myContact = navigator.contacts.create ({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+El `navigator.contacts.find` método se ejecuta asincrónicamente, consultando la base de datos de contactos de dispositivo y devolver una matriz de `Contact` objetos. Los objetos resultantes son pasados a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda. Un parámetro de longitud cero **contactFields** no es válido y resultados en `ContactError.INVALID_ARGUMENT_ERROR` . Un valor de **contactFields** de `"*"` busca campos todo contactos.
+
+La cadena de **contactFindOptions.filter** puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, una entre mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields** . Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto. Uso **contactFindOptions.desiredFields** parámetro al control que Contacta con propiedades debe devolverse atrás.
+
+### Parámetros
+
+*   **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. *(DOMString[])* [Required]
+
+*   **contactSuccess**: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Required]
+
+*   **contactError**: función de callback de Error, se invoca cuando se produce un error. [Optional]
+
+*   **contactFindOptions**: buscar opciones para filtrar navigator.contacts. [Optional]
+    
+    Claves incluyen:
+    
+    *   **filtro**: la cadena de búsqueda utilizada para encontrar navigator.contacts. *(DOMString)* (Por defecto:`""`)
+    
+    *   **múltiples**: determina si la operación de búsqueda devuelve múltiples navigator.contacts. *(Booleano)* (Por defecto:`false`)
+        
+        *   **desiredFields**: póngase en contacto con campos para volver atrás. Si se especifica, la resultante `Contact` objeto sólo cuenta con los valores de estos campos. *(DOMString[])* [Optional]
+
+### Plataformas soportadas
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+*   Windows (sólo dispositivos Windows Phone 8.1)
+
+### Ejemplo
+
+    function onSuccess(contacts) {alert ('Encontrados' + contacts.length + 'contactos de.');};
+    
+    function onError(contactError) {alert('onError!');};
+    
+    encuentra todos los contactos con 'Bob' en cualquier nombre campo var opciones = new ContactFindOptions();
+    options.Filter = "Bob";
+    options.Multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    campos var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    Navigator.contacts.Find (campos, onSuccess, onError, opciones);
+    
+
+### Windows rarezas
+
+*   `__contactFields__`No se admite y se ignorará. `find`método siempre tratará de coincidir con el nombre, dirección de correo electrónico o número de teléfono de un contacto.
+
+## navigator.contacts.pickContact
+
+El `navigator.contacts.pickContact` método lanza el selector para seleccionar un único contacto contacto. El objeto resultante se pasa a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+### Parámetros
+
+*   **contactSuccess**: función de callback de éxito se invoca con el único objeto de contacto. [Obligatorio]
+
+*   **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+
+### Plataformas soportadas
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### Ejemplo
+
+    navigator.contacts.pickContact(function(contact) {console.log (' se ha seleccionado el siguiente contacto: "+ JSON.stringify(contact));
+        }, function(err) {console.log ('Error: ' + err);
+        });
+    
+
+## Contact
+
+El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser creados, almacenados o eliminados de la base de datos de contactos de dispositivo. Contactos pueden también ser obtenidos (individualmente o a granel) de la base de datos invocando el `navigator.contacts.find` método.
+
+**Nota**: no todos los campos de contacto mencionados son compatibles con la plataforma de cada dispositivo. Consulte sección *peculiaridades* de cada plataforma para más detalles.
+
+### Propiedades
+
+*   **ID**: un identificador único global. *(DOMString)*
+
+*   **displayName**: el nombre de este contacto, conveniente para la exhibición a los usuarios finales. *(DOMString)*
+
+*   **nombre**: un objeto que contiene todos los componentes de un nombre de las personas. *(ContactName)*
+
+*   **apodo**: un nombre para abordar el contacto casual. *(DOMString)*
+
+*   **números**: una matriz de números de teléfono de contacto. *(ContactField[])*
+
+*   **correos electrónicos**: un conjunto de direcciones de correo electrónico del contacto. *(ContactField[])*
+
+*   **direcciones**: un conjunto de direcciones de todos los contactos. *(ContactAddress[])*
+
+*   **IMS**: un conjunto de direcciones de todos los contactos IM. *(ContactField[])*
+
+*   **organizaciones**: un conjunto de organizaciones de todos los contactos. *(ContactOrganization[])*
+
+*   **cumpleaños**: el cumpleaños del contacto. *(Fecha)*
+
+*   **Nota**: una nota sobre el contacto. *(DOMString)*
+
+*   **fotos**: una serie de fotos de los contactos. *(ContactField[])*
+
+*   **categorías**: una matriz de todas las categorías definidas por el usuario asociado con el contacto. *(ContactField[])*
+
+*   **URL**: un conjunto de páginas web asociadas con el contacto. *(ContactField[])*
+
+### Métodos
+
+*   **clon**: devuelve un nuevo `Contact` objeto que es una copia en profundidad del objeto de llamadas con el `id` propiedad establecida en`null`.
+
+*   **eliminar**: elimina el contacto de la base de datos de contactos de dispositivo, si no se ejecuta un callback de error con un `ContactError` objeto.
+
+*   **Guardar**: guarda un nuevo contacto en la base de datos de contactos de dispositivo o actualiza un contacto existente si ya existe un contacto con el mismo **id** .
+
+### Plataformas soportadas
+
+*   Amazon fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+*   Windows 8
+*   Windows
+
+### Salvar ejemplo
+
+    function onSuccess(contact) {alert ("salvar con éxito");};
+    
+    function onError(contactError) {alert ("Error =" + contactError.code);};
+    
+    crear un nuevo objeto contacto var contacto = navigator.contacts.create();
+    contact.displayName = "Plomero";
+    Contact.nickname = "Plomero";            especificar tanto para todos los dispositivos de apoyo / / rellenar algún nombre var campos = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    Contact.name = nombre;
+    
+    guardar en el dispositivo contact.save(onSuccess,onError);
+    
+
+### Ejemplo de clon
+
+        clon del clon de contacto objeto var = contact.clone();
+        clone.name.givenName = "John";
+        Console.log ("contacto Original nombre =" + contact.name.givenName);
+        Console.log ("Cloned contacto nombre =" + clone.name.givenName);
+    
+
+### Quitar ejemplo
+
+    function onSuccess() {alert ("retiro el éxito");};
+    
+    function onError(contactError) {alert ("Error =" + contactError.code);};
+    
+    quitar el contacto de la contact.remove(onSuccess,onError) del dispositivo;
+    
+
+### Rarezas Android 2.X
+
+*   **categories**: no compatible con dispositivos Android 2.X, devolver `null`.
+
+### BlackBerry 10 rarezas
+
+*   **ID**: asignado por el dispositivo cuando se guarda el contacto.
+
+### FirefoxOS rarezas
+
+*   **categorías**: parcialmente soportado. Campos **pref** y **tipo** regresan`null`
+
+*   **IMS**: no se admite
+
+*   **fotos**: no se admite
+
+### iOS rarezas
+
+*   **displayName**: no compatible con iOS, regresando `null` si no hay ningún `ContactName` especifica, en cuyo caso devuelve el nombre del compuesto, **apodo** o `""` , respectivamente.
+
+*   **cumpleaños**: debe ser de entrada como un JavaScript `Date` objeto, del mismo modo que se la devuelvan.
+
+*   **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación. Contenidos del directorio temporal se eliminan cuando salga de la aplicación.
+
+*   **categorías**: esta propiedad actualmente no es compatible, regresando`null`.
+
+### Windows Phone 7 y 8 rarezas
+
+*   **displayName**: cuando se crea un contacto, previsto para el parámetro de nombre pantalla difiere el nombre para mostrar el valor obtenido al encontrar el contacto.
+
+*   **URL**: cuando se crea un contacto, los usuarios pueden ingresar y salvar más de una dirección web, pero sólo está disponible cuando busque el contacto.
+
+*   **números**: no se admite la opción *pref* . El *tipo* no se admite en una operación de *encontrar* . Solamente un `phoneNumber` está permitido para cada *tipo*.
+
+*   **correos electrónicos**: no se admite la opción *pref* . Home y referencias misma entrada de correo electrónico. Se permite solamente una entrada para cada *tipo*.
+
+*   **direcciones**: soporta sólo trabajo y hogar/personal *tipo*. La casa y personales de *tipo* referencia la misma entrada de dirección. Se permite solamente una entrada para cada *tipo*.
+
+*   **organizaciones**: sólo está permitido y no es compatible con los atributos *pref*, *tipo*y *Departamento* .
+
+*   **Nota**: no compatible, regresando`null`.
+
+*   **ims**: no soportado, devolver `null`.
+
+*   **cumpleaños**: no soportado, regresando`null`.
+
+*   **categorías**: no soportado, regresando`null`.
+
+### Windows rarezas
+
+*   **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación.
+
+*   **cumpleaños**: no soportado, regresando`null`.
+
+*   **categorías**: no soportado, regresando`null`.
+
+## ContactAddress
+
+El `ContactAddress` objeto almacena las propiedades de una única dirección de un contacto. A `Contact` objeto puede incluir más de una dirección en un `ContactAddress[]` matriz.
+
+### Propiedades
+
+*   **pref**: establecido en `true` si esta `ContactAddress` contiene el usuario preferido de valor. *(boolean)*
+
+*   **type**: una cadena que indica qué tipo de campo es, *home* por ejemplo. *(DOMString)*
+
+*   **formatted**: la dirección completa con formato de visualización. *(DOMString)*
+
+*   **streetAddress**: la dirección completa. *(DOMString)*
+
+*   **locality**: la ciudad o localidad. *(DOMString)*
+
+*   **region**: el estado o la región. *(DOMString)*
+
+*   **postalCode**: el código postal o código postal. *(DOMString)*
+
+*   **country**: el nombre del país. *(DOMString)*
+
+### Plataformas soportadas
+
+*   Amazon fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+*   Windows 8
+*   Windows
+
+### Ejemplo
+
+    Mostrar la información de dirección para el funcionan de todos los contactos onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {para (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + "\n" + "tipo:" + contacts[i].addresses[j].type + "\n" + "formato:" + contacts[i].addresses[j].formatted + "\n" + "dirección: "+ contacts[i].addresses[j].streetAddress +"\n"+" localidad: "+ contacts[i].addresses[j].locality +"\n"+" región: "+ contacts[i].addresses[j].region +"\n"+" Código Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" país: "+ contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');};
+    
+    encontrar todos los contactos var opciones = new ContactFindOptions();
+    options.Filter = "";
+    filtro var = ["displayName", "direcciones"];
+    Navigator.contacts.Find (filtro, onSuccess, onError, opciones);
+    
+
+### Rarezas Android 2.X
+
+*   **pref**: no soportado, devolviendo `false` en dispositivos Android 2.X.
+
+### BlackBerry 10 rarezas
+
+*   **pref**: no compatible con dispositivos BlackBerry, devolviendo `false`.
+
+*   **type**: parcialmente soportado. Sólo uno de cada *Work* y *Home* tipo direcciones puede ser almacenado por contacto.
+
+*   **formatted**: parcialmente soportado. Devuelve una concatenación de todos los campos de dirección de BlackBerry.
+
+*   **streetAddress**: soportado. Devuelve una concatenación de BlackBerry **address1** y **2** campos de dirección.
+
+*   **locality**: apoyado. Almacenada en el campo de dirección de la **city** de BlackBerry.
+
+*   **region**: apoyado. Almacenada en el campo de dirección de BlackBerry **stateProvince**.
+
+*   **postalCode**: apoyado. Almacenada en el campo de dirección de BlackBerry **zipPostal**.
+
+*   **country**: apoyado.
+
+### FirefoxOS rarezas
+
+*   **formato**: actualmente no se admite
+
+### iOS rarezas
+
+*   **pref**: no se admite en dispositivos iOS, devolviendo `false`.
+
+*   **formatted**: actualmente no se admite.
+
+### Rarezas de Windows 8
+
+*   **Pref**: no se admite
+
+### Windows rarezas
+
+*   **Pref**: no se admite
+
+## ContactError
+
+El `ContactError` objeto se devuelve al usuario a través de la `contactError` función de devolución de llamada cuando se produce un error.
+
+### Propiedades
+
+*   **code**: uno de los códigos de error predefinido enumerados a continuación.
+
+### Constantes
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+El `ContactField` objeto es un componente reutilizable que representa en contacto con campos genéricamente. Cada `ContactField` objeto contiene un `value` , `type` , y `pref` propiedad. A `Contact` objeto almacena varias propiedades en `ContactField[]` arreglos de discos, como las direcciones de teléfono números y correo electrónico.
+
+En la mayoría de los casos, no existen previamente determinados valores para un `ContactField` atributo **type** del objeto. Por ejemplo, un número de teléfono puede especificar valores de **tipo** de *hogar*, *trabajo*, *móvil*, *iPhone*o cualquier otro valor que es apoyado por contacto de base de datos de una plataforma dispositivo determinado. Sin embargo, para el `Contact` **fotos de** campo, el campo **tipo** indica el formato de la imagen devuelta: **url** cuando el atributo de **valor** contiene una dirección URL de la imagen de la foto, o *base64* cuando el **valor** contiene una cadena codificada en base64 imagen.
+
+### Propiedades
+
+*   **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. *(DOMString)*
+
+*   **valor**: el valor del campo, como un teléfono número o dirección de email. *(DOMString)*
+
+*   **Pref**: A `true` si este `ContactField` contiene el valor del usuario preferido. *(booleano)*
+
+### Plataformas soportadas
+
+*   Amazon fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+*   Windows 8
+*   Windows
+
+### Ejemplo
+
+        crear un nuevo contacto contacto var = navigator.contacts.create();
+    
+        almacenar números de teléfono de contacto en números de var ContactField [] = [];
+        phoneNumbers[0] = new ContactField ('trabajo', ' 212-555-1234', false);
+        phoneNumbers[1] = new ContactField ('móviles', ' 917-555-5432', true); recomendado: número phoneNumbers[2] = new ContactField ('home', ' 203-555-7890', false);
+        contact.phoneNumbers = números;
+    
+        guardar el contacto contact.save();
+    
+
+### Rarezas Android
+
+*   **Pref**: no soportado, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+*   **tipo**: parcialmente soportado. Utilizado para los números de teléfono.
+
+*   **valor**: apoyado.
+
+*   **Pref**: no soportado, regresando`false`.
+
+### iOS rarezas
+
+*   **Pref**: no soportado, regresando`false`.
+
+### Windows8 rarezas
+
+*   **Pref**: no soportado, regresando`false`.
+
+### Windows rarezas
+
+*   **Pref**: no soportado, regresando`false`.
+
+## ContactName
+
+Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
+
+### Propiedades
+
+*   **formato**: el nombre completo del contacto. *(DOMString)*
+
+*   **familia**: el nombre del contacto familiar. *(DOMString)*
+
+*   **givenName**: nombre del contacto. *(DOMString)*
+
+*   **middleName**: el nombre del contacto media. *(DOMString)*
+
+*   **honorificPrefix**: prefijo del contacto (ejemplo *señor* o *doctor*) *(DOMString)*
+
+*   **honorificSuffix**: sufijo de contacto (ejemplo *Esq.*). *(DOMString)*
+
+### Plataformas soportadas
+
+*   Amazon fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+*   Windows 8
+*   Windows
+
+### Ejemplo
+
+    función onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {alert ("formateada:" + contacts[i].name.formatted + "\n" + "Apellido:" + contacts[i].name.familyName + "\n" + "nombre:" + contacts[i].name.givenName + "\n" + "segundo nombre:" + contacts[i].name.middleName + "\n" + "sufijo:" + contacts[i].name.honorificSuffix + "\n" + "prefijo:" + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');};
+    
+    var opciones = new ContactFindOptions();
+    options.Filter = "";
+    filtro = ["displayName", "nombre"];
+    Navigator.contacts.Find (filtro, onSuccess, onError, opciones);
+    
+
+### Rarezas Android
+
+*   **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### BlackBerry 10 rarezas
+
+*   **formato**: parcialmente soportado. Devuelve una concatenación de campos **firstName** y **lastName** de BlackBerry.
+
+*   **familia**: apoyo. Almacenada en el campo **lastName** BlackBerry.
+
+*   **givenName**: apoyado. Almacenados en campo **firstName** BlackBerry.
+
+*   **middleName**: no soportado, regresando`null`.
+
+*   **honorificPrefix**: no soportado, regresando`null`.
+
+*   **honorificSuffix**: no soportado, regresando`null`.
+
+### FirefoxOS rarezas
+
+*   **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### iOS rarezas
+
+*   **formato**: parcialmente soportado. Devuelve iOS nombre compuesto, pero es de sólo lectura.
+
+### Rarezas de Windows 8
+
+*   **formato**: este es el único nombre de propiedad y es idéntico al `displayName` , y`nickname`
+
+*   **familia**: no se admite
+
+*   **givenName**: no se admite
+
+*   **middleName**: no se admite
+
+*   **honorificPrefix**: no se admite
+
+*   **honorificSuffix**: no se admite
+
+### Windows rarezas
+
+*   **formato**: es idéntica a`displayName`
+
+## ContactOrganization
+
+El `ContactOrganization` objeto almacena las propiedades de organización de un contacto. A `Contact` objeto almacena uno o más `ContactOrganization` los objetos en una matriz.
+
+### Propiedades
+
+*   **Pref**: A `true` si este `ContactOrganization` contiene el valor del usuario preferido. *(booleano)*
+
+*   **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. _(DOMString)
+
+*   **nombre**: el nombre de la organización. *(DOMString)*
+
+*   **Departamento**: el contrato de obras para el departamento. *(DOMString)*
+
+*   **título**: título del contacto de la organización. *(DOMString)*
+
+### Plataformas soportadas
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 y 8
+*   Windows (sólo dispositivos Windows 8.1 y 8.1 de Windows Phone)
+
+### Ejemplo
+
+    function onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {para (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + "\n" + "tipo:" + contacts[i].organizations[j].type + "\n" + "nombre:" + contacts[i].organizations[j].name + "\n" + "Departamento:" + contacts[i].organizations[j].department + "\n" + "título: "+ contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');};
+    
+    var opciones = new ContactFindOptions();
+    options.Filter = "";
+    filtro = ["displayName", "organizaciones"];
+    Navigator.contacts.Find (filtro, onSuccess, onError, opciones);
+    
+
+### Rarezas Android 2.X
+
+*   **Pref**: no compatible con dispositivos Android 2.X, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+*   **Pref**: no compatible con dispositivos BlackBerry, regresando`false`.
+
+*   **tipo**: no compatible con dispositivos BlackBerry, regresando`null`.
+
+*   **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de la **empresa** BlackBerry.
+
+*   **Departamento**: no soportado, regresando`null`.
+
+*   **título**: parcialmente soportado. El primer título de la organización se almacena en el campo de **jobTitle** BlackBerry.
+
+### Firefox OS rarezas
+
+*   **Pref**: no se admite
+
+*   **tipo**: no se admite
+
+*   **Departamento**: no se admite
+
+*   Los campos **nombre** y **título** almacenado en **org** y **jobTitle**.
+
+### iOS rarezas
+
+*   **pref**: no se admite en dispositivos iOS, devolviendo `false`.
+
+*   **tipo**: no se admite en dispositivos iOS, regresando`null`.
+
+*   **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de **kABPersonOrganizationProperty** de iOS.
+
+*   **Departamento**: parcialmente soportado. El primer nombre de departamento se almacena en el campo de **kABPersonDepartmentProperty** de iOS.
+
+*   **título**: parcialmente soportado. El primer título se almacena en el campo de **kABPersonJobTitleProperty** de iOS.
+
+### Windows rarezas
+
+*   **Pref**: no soportado, regresando`false`.
+
+*   **tipo**: no soportado, regresando`null`.

km0App/node_modules/cordova-plugin-contacts/doc/fr/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Ce plugin définit un global `navigator.contacts` objet, ce qui permet d'accéder à la base de données de contacts de dispositif.
+
+Bien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.
+
+    document.addEventListener (« deviceready », onDeviceReady, false) ;
+    function onDeviceReady() {console.log(navigator.contacts);}
+    
+
+**Avertissement**: collecte et utilisation des données de contact soulève des questions importantes de la vie privée. Politique de confidentialité de votre application doit examiner comment l'application utilise les données de contact et si il est partagé avec d'autres parties. Information de contact est considéré comme sensible parce qu'il révèle les gens avec lesquels une personne communique. Par conséquent, en plus de la politique de confidentialité de l'application, vous devez envisager fortement fournissant un avis juste-à-temps, avant que l'application accède ou utilise des données de contact, si le système d'exploitation de périphérique ne fait donc pas déjà. Cet avis doit fournir les mêmes renseignements susmentionnées, ainsi que d'obtenir l'autorisation de l'utilisateur (par exemple, en présentant des choix **OK** et **Non merci**). Notez que certains marchés app peuvent exiger l'application de fournir un avis juste-à-temps et obtenir la permission de l'utilisateur avant d'accéder à des données de contact. Une expérience utilisateur claire et facile à comprendre qui entourent l'utilisation de données permettent d'éviter la confusion des utilisateurs de contact et une utilisation jugée abusive des données de contact. Pour plus d'informations, consultez le Guide de la vie privée.
+
+## Installation
+
+Pour cela, cordova 5.0 + (v1.0.0 stable actuelle)
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+Anciennes versions de cordova peuvent toujours installer via l'id **déconseillée** (v0.2.16 rassis)
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+Il est également possible d'installer directement via l'url de repo (instable)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### Firefox OS Quirks
+
+Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste](https://developer.mozilla.org/en-US/Apps/Developing/Manifest). Ajouter permisions pertinentes. Il est également nécessaire de changer le type d'application Web de « privilégiés » - [Docs manifeste](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type). **Avertissement**: toutes les applications privilégiées appliquer [Contenu politique de sécurité](https://developer.mozilla.org/en-US/Apps/CSP) qui interdit à un script inline. Initialiser votre application d'une autre manière.
+
+    « type »: "le privilège", "autorisations": {« contacts »: {« accès »: "readwrite", "description": "décrire pourquoi il est nécessaire pour obtenir cette permission"}}
+    
+
+### Bizarreries de Windows
+
+**Avant Windows 10 :** Tout contact retourné par les méthodes `find` et `pickContact` est en lecture seule, afin que votre application ne puisse les modifier. `find`méthode disponible uniquement sur les appareils Windows Phone 8.1.
+
+**Windows 10 et plus :** Contacts peuvent être enregistrées et seront enregistrées dans le stockage local application contacts. Contacts peuvent également être supprimés.
+
+### Bizarreries de Windows 8
+
+Windows 8 Contacts sont en lecture seule. Via les Contacts d'API Cordova ne sont pas queryable/consultables, vous devez en informer l'utilisateur de choisir un contact comme un appel à contacts.pickContact qui va ouvrir l'application « People » où l'utilisateur doit choisir un contact. Les contacts retournés sont en lecture seule, afin que votre application ne puisse les modifier.
+
+## Navigator.contacts
+
+### Méthodes
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### Objets
+
+  * Contact
+  * ContactName
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+La `navigator.contacts.create` méthode est synchrone et retourne un nouveau `Contact` objet.
+
+Cette méthode ne conserve pas l'objet de Contact dans la base de données des contacts périphériques, dont vous avez besoin d'appeler le `Contact.save` méthode.
+
+### Plates-formes supportées
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+
+### Exemple
+
+    myContact var = navigator.contacts.create ({« displayName »: « Test User »}) ;
+    
+
+## navigator.contacts.find
+
+La `navigator.contacts.find` méthode s'exécute de façon asynchrone, l'interrogation de la base de données de contacts de dispositif et retourne un tableau de `Contact` objets. Les objets résultants sont passés à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+Le paramètre **contactFields** spécifie les champs à utiliser comme un qualificateur de recherche. Un paramètre de longueur nulle **contactFields** n'est pas valide et se traduit par `ContactError.INVALID_ARGUMENT_ERROR` . Une valeur de **contactFields** de `"*"` recherche dans les champs de tout contact.
+
+La chaîne **contactFindOptions.filter** peut servir comme un filtre de recherche lors de l'interrogation de la base de données de contacts. Si fourni, un non-respect de la casse, correspondance de valeur partielle est appliquée à chaque champ spécifié dans le paramètre **contactFields** . S'il y a une correspondance pour *n'importe quel* des champs spécifiés, le contact est retourné. Utilisation **contactFindOptions.desiredFields** paramètre de contrôle qui contacter propriétés doit être retourné au retour.
+
+### Paramètres
+
+  * **contactFields**: communiquer avec les champs à utiliser comme un qualificateur de recherche. *(DOMString[])* [Required]
+
+  * **contactSuccess**: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Required]
+
+  * **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+  * **contactFindOptions**: recherche d'options pour filtrer navigator.contacts. [Optional]
+    
+    Clés incluent :
+    
+      * **filtre**: la chaîne de recherche utilisée pour trouver navigator.contacts. *(DOMString)* (Par défaut :`""`)
+    
+      * **multiples**: détermine si l'opération find retourne plusieurs navigator.contacts. *(Booléen)* (Par défaut :`false`)
+        
+          * **desiredFields**: Contactez champs soit retourné en arrière. Si spécifié, l'entraînant `Contact` objet dispose seulement des valeurs de ces champs. *(DOMString[])* [Optional]
+
+### Plates-formes supportées
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+  * Windows (Windows Phone, 8.1 et Windows 10)
+
+### Exemple
+
+    function onSuccess(contacts) {alert (« Found » + contacts.length + « contacts. »);} ;
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    trouver tous les contacts avec « Bob » dans toute option de var de champ nom = new ContactFindOptions() ;
+    options.Filter = « Bob » ;
+    options.multiple = true ;
+    options.desiredFields = [navigator.contacts.fieldType.id] ;
+    champs var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name] ;
+    Navigator.contacts.Find (champs, onSuccess, onError, options) ;
+    
+
+### Bizarreries de Windows
+
+  * `__contactFields__`n'est pas prise en charge et sera ignorée. `find`méthode toujours tenter de faire correspondre le nom, adresse e-mail ou numéro de téléphone d'un contact.
+
+## navigator.contacts.pickContact
+
+La `navigator.contacts.pickContact` méthode lance le sélecteur de Contact pour sélectionner un contact unique. L'objet qui en résulte est passé à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+### Paramètres
+
+  * **contactSuccess**: fonction de rappel de succès appelée avec l'objet de Contact unique. [Obligatoire]
+
+  * **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+### Plates-formes supportées
+
+  * Android
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### Exemple
+
+    navigator.contacts.pickContact(function(contact) {console.log ("le contact suivant a été retenu:" + JSON.stringify(contact)) ;
+        }, function(err) {console.log ("Error:" + err) ;
+        });
+    
+
+## Contact
+
+Le `Contact` objet représente le contact de l'utilisateur. Contacts peuvent être créés, conservés ou supprimés de la base de données de contacts de dispositif. Contacts peuvent également être récupérées (individuellement ou en vrac) de la base de données en appelant le `navigator.contacts.find` méthode.
+
+**NOTE**: tous les champs de contact susmentionnés ne sont pris en charge sur chaque plate-forme de périphérique. S'il vous plaît vérifier la section *bizarreries* de chaque plate-forme pour plus de détails.
+
+### Propriétés
+
+  * **ID**: un identificateur global unique. *(DOMString)*
+
+  * **displayName**: le nom de ce Contact, approprié pour l'affichage à l'utilisateur final. *(DOMString)*
+
+  * **nom**: un objet contenant tous les composants d'un nom de personnes. *(ContactName)*
+
+  * **Pseudo**: un nom occasionnel permettant de régler le contact. *(DOMString)*
+
+  * **phoneNumbers**: un tableau des numéros de téléphone du contact. *(ContactField[])*
+
+  * **courriels**: un tableau d'adresses de courriel du contact. *(ContactField[])*
+
+  * **adresses**: un tableau d'adresses tous les contacts. *(ContactAddress[])*
+
+  * **IMS**: un tableau d'adresses IM tout le contact. *(ContactField[])*
+
+  * **organisations**: un tableau des organisations de tout le contact. *(ContactOrganization[])*
+
+  * **anniversaire**: l'anniversaire du contact. *(Date)*
+
+  * **Remarque**: une remarque sur le contact. *(DOMString)*
+
+  * **photos**: un tableau de photos du contact. *(ContactField[])*
+
+  * **catégories**: un tableau de toutes les catégories définies par l'utilisateur attribuée au contact. *(ContactField[])*
+
+  * **URL**: un tableau des pages web attribuée au contact. *(ContactField[])*
+
+### Méthodes
+
+  * **Clone**: retourne un nouveau `Contact` objet qui est une copie complète de l'objet appelant, avec le `id` propriété la valeur`null`.
+
+  * **supprimer**: supprime le contact de la base de données de contacts de dispositif, sinon exécute un rappel d'erreur avec un `ContactError` objet.
+
+  * **Enregistrer**: enregistre un nouveau contact dans la base de données de contacts de périphérique, ou met à jour un contact existant, si un contact avec le même **id** existe déjà.
+
+### Plates-formes supportées
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+  * Windows 8
+  * Windows
+
+### Enregistrez l'exemple
+
+    function onSuccess(contact) {alert ("sauver succès");} ;
+    
+    function onError(contactError) {alert ("erreur =" + contactError.code);} ;
+    
+    créer un objet contact contact var = navigator.contacts.create() ;
+    contact.displayName = « Plombier » ;
+    contact.Nickname = « Plombier » ;            spécifier à la fois pour prendre en charge tous les périphériques / / renseigner certains champs var nom = new ContactName() ;
+    name.givenName = « Jane » ;
+    name.familyName = « Doe » ;
+    contact.name = nom ;
+    
+    enregistrer dans contact.save(onSuccess,onError) de l'appareil ;
+    
+
+### Exemple de clone
+
+        Clone clone objet contact var = contact.clone() ;
+        clone.name.givenName = « John » ;
+        Console.log ("contact Original nom =" + contact.name.givenName) ;
+        Console.log ("nom de contact clonés =" + clone.name.givenName) ;
+    
+
+### Supprimer l'exemple
+
+    fonction onSuccess() {alert ("succès");} ;
+    
+    function onError(contactError) {alert ("erreur =" + contactError.code);} ;
+    
+    supprimer le contact de l'appareil contact.remove(onSuccess,onError) ;
+    
+
+### Android 2.X Quirks
+
+  * **catégories**: non pris en charge sur les périphériques Android 2.X, retour`null`.
+
+### BlackBerry 10 Quirks
+
+  * **ID**: assignés par l'appareil lors de l'enregistrement du contact.
+
+### Bizarreries de FirefoxOS
+
+  * **catégories**: partiellement pris en charge. Champs **pref** et **type** sont de retour`null`
+
+  * **IMS**: non pris en charge
+
+  * **photos**: ne pas pris en charge
+
+### Notes au sujet d'iOS
+
+  * **displayName**: ne pas possible sur iOS, retour `null` à moins qu'il n'y a aucun `ContactName` spécifié, auquel cas, il renvoie le nom composite, **Pseudo** ou `""` , respectivement.
+
+  * **anniversaire**: doit être entré comme un JavaScript `Date` objet, de la même façon qu'il soit retourné.
+
+  * **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application. Contenu du répertoire temporaire est supprimés lorsque l'application se ferme.
+
+  * **catégories**: cette propriété n'est actuellement pas supportée, retour`null`.
+
+### Notes au sujet de Windows Phone 7 et 8
+
+  * **displayName**: lorsque vous créez un contact, la valeur fournie pour le paramètre de nom d'affichage est différent de l'affichage nom Récupérée lors de la recherche du contact.
+
+  * **URL**: lorsque vous créez un contact, les utilisateurs peuvent entrer et enregistrer plus d'une adresse web, mais seulement un est disponible lors de la recherche du contact.
+
+  * **phoneNumbers**: l'option de *pref* n'est pas pris en charge. Le *type* n'est pas pris en charge lors d'une opération de *trouver* . Seul `phoneNumber` est autorisé pour chaque *type*.
+
+  * **courriels**: l'option de *pref* n'est pas pris en charge. Accueil et personnels références même courriel entrée. Une seule participation est autorisée pour chaque *type*.
+
+  * **adresses**: prend en charge seulement travail et accueil/personal *type*. La maison et personnels de *type* référence la même entrée d'adresse. Une seule participation est autorisée pour chaque *type*.
+
+  * **organisations**: seul est autorisé et ne supporte pas les attributs *pref*, *type*et *Département* .
+
+  * **Remarque**: ne pas pris en charge, retour`null`.
+
+  * **IMS**: ne pas pris en charge, retour`null`.
+
+  * **anniversaires**: ne pas pris en charge, retour`null`.
+
+  * **catégories**: ne pas pris en charge, retour`null`.
+
+  * **remove**: méthode n'est pas prise en charge
+
+### Bizarreries de Windows
+
+  * **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application.
+
+  * **anniversaires**: ne pas pris en charge, retour`null`.
+
+  * **catégories**: ne pas pris en charge, retour`null`.
+
+  * **remove**: méthode est uniquement pris en charge dans Windows 10 ou supérieur.
+
+## ContactAddress
+
+Le `ContactAddress` objet Stocke les propriétés d'une seule adresse d'un contact. A `Contact` objet peut inclure plusieurs adresses dans un `ContactAddress[]` tableau.
+
+### Propriétés
+
+  * **pref**: la valeur `true` si ce `ContactAddress` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+  * **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
+
+  * **mise en forme**: l'adresse complète au format pour l'affichage. *(DOMString)*
+
+  * **adresse**: l'adresse complète. *(DOMString)*
+
+  * **localité**: la ville ou la localité. *(DOMString)*
+
+  * **région**: l'État ou la région. *(DOMString)*
+
+  * **Code postal**: le code zip ou code postal. *(DOMString)*
+
+  * **pays**: le nom du pays. *(DOMString)*
+
+### Plates-formes supportées
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+  * Windows 8
+  * Windows
+
+### Exemple
+
+    Affichez les informations d'adresse pour tous les contacts fonctionnent onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + « \n » + "Type:" + contacts[i].addresses[j].type + « \n » + "au format:" + contacts[i].addresses[j].formatted + « \n » + "adresse de rue: "+ contacts[i].addresses[j].streetAddress +"\n"+" localité: "+ contacts[i].addresses[j].locality +"\n"+" région: "+ contacts[i].addresses[j].region +"\n"+" Code Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" pays: "+ contacts[i].addresses[j].country) ;
+            }
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    trouver tous les contacts options var = new ContactFindOptions() ;
+    options.Filter = "" ;
+    filtre var = ["name", « adresses »] ;
+    Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+    
+
+### Android 2.X Quirks
+
+  * **pref**: ne pas pris en charge, retour `false` sur les appareils Android 2.X.
+
+### BlackBerry 10 Quirks
+
+  * **pref**: non pris en charge sur les appareils BlackBerry, retour`false`.
+
+  * **type**: partiellement pris en charge. Seule chaque de *travail* et tapez les adresses de *la maison* peut être stockée par contact.
+
+  * **au format**: partiellement pris en charge. Retourne la concaténation de tous les champs d'adresse BlackBerry.
+
+  * **streetAddress**: prise en charge. Retourne la concaténation de BlackBerry **address1** et **address2** champs d'adresse.
+
+  * **localité**: prise en charge. Stockée dans le champ d'adresse BlackBerry **ville** .
+
+  * **région**: pris en charge. Stockée dans le champ d'adresse BlackBerry **stateProvince** .
+
+  * **Code postal**: prise en charge. Stockée dans le champ d'adresse BlackBerry **zipPostal** .
+
+  * **pays**: prise en charge.
+
+### Bizarreries de FirefoxOS
+
+  * **au format**: actuellement ne pas pris en charge
+
+### Notes au sujet d'iOS
+
+  * **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+  * **au format**: actuellement ne pas pris en charge.
+
+### Bizarreries de Windows 8
+
+  * **pref**: non pris en charge
+
+### Bizarreries de Windows
+
+  * **pref**: non pris en charge
+
+## ContactError
+
+Le `ContactError` objet est retourné à l'utilisateur via le `contactError` fonction de rappel lorsqu'une erreur survient.
+
+### Propriétés
+
+  * **code**: l'un des codes d'erreur prédéfinis énumérés ci-dessous.
+
+### Constantes
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Le `ContactField` objet est un composant réutilisable que représente contacter champs génériquement. Chaque `ContactField` objet contient un `value` , `type` , et `pref` propriété. A `Contact` objet stocke plusieurs propriétés dans `ContactField[]` tableaux, tels que téléphone numéros et adresses e-mail.
+
+Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour une `ContactField` l'attribut **type** de l'objet. Par exemple, un numéro de téléphone peut spécifier des valeurs de **type** de la *maison*, *travail*, *mobile*, *iPhone*ou toute autre valeur qui est pris en charge par la base de contacts de la plate-forme un périphérique particulier. Toutefois, pour les `Contact` **photos** champ, le champ **type** indique le format de l'image retournée : **url** lorsque l'attribut **value** contient une URL vers l'image photo ou *base64* lorsque la **valeur** contient une chaîne codée en base64 image.
+
+### Propriétés
+
+  * **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
+
+  * **valeur**: la valeur du champ, comme un téléphone numéro ou adresse e-mail. *(DOMString)*
+
+  * **pref**: la valeur `true` si ce `ContactField` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+### Plates-formes supportées
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+  * Windows 8
+  * Windows
+
+### Exemple
+
+        créer un nouveau contact contact var = navigator.contacts.create() ;
+    
+        stocker des numéros de téléphone de contact en ContactField [] var phoneNumbers = [] ;
+        phoneNumbers[0] = new ContactField (« travail », ' 212-555-1234', false) ;
+        phoneNumbers[1] = new ContactField (« mobile », ' 917-555-5432', true) ; phoneNumbers[2] numéro préféré = new ContactField (« home », ' 203-555-7890', false) ;
+        contact.phoneNumbers = phoneNumbers ;
+    
+        enregistrer le contact contact.save() ;
+    
+
+### Quirks Android
+
+  * **pref**: ne pas pris en charge, retour`false`.
+
+### BlackBerry 10 Quirks
+
+  * **type**: partiellement pris en charge. Utilisé pour les numéros de téléphone.
+
+  * **valeur**: prise en charge.
+
+  * **pref**: ne pas pris en charge, retour`false`.
+
+### Notes au sujet d'iOS
+
+  * **pref**: ne pas pris en charge, retour`false`.
+
+### Quirks Windows8
+
+  * **pref**: ne pas pris en charge, retour`false`.
+
+### Bizarreries de Windows
+
+  * **pref**: ne pas pris en charge, retour`false`.
+
+## ContactName
+
+Contient différents types d'informations sur un `Contact` nom de l'objet.
+
+### Propriétés
+
+  * **mise en forme**: le nom complet du contact. *(DOMString)*
+
+  * **familyName**: nom de famille du contact. *(DOMString)*
+
+  * **givenName**: prénom du contact. *(DOMString)*
+
+  * **middleName**: deuxième prénom du contact. *(DOMString)*
+
+  * **honorificPrefix**: préfixe du contact (exemple *M.* ou *Mme*) *(DOMString)*
+
+  * **honorificSuffix**: suffixe du contact (exemple *Esq.*). *(DOMString)*
+
+### Plates-formes supportées
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+  * Windows 8
+  * Windows
+
+### Exemple
+
+    function onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {alert ("Formatted:" + contacts[i].name.formatted + « \n » + "patronyme:" + contacts[i].name.familyName + « \n » + "Prénom:" + contacts[i].name.givenName + « \n » + "Prénom:" + contacts[i].name.middleName + « \n » + "suffixe:" + contacts[i].name.honorificSuffix + « \n » + "préfixe:" + contacts[i].name.honorificSuffix) ;
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    options de var = new ContactFindOptions() ;
+    options.Filter = "" ;
+    filtre = ["name", « nom »] ;
+    Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+    
+
+### Quirks Android
+
+  * **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### BlackBerry 10 Quirks
+
+  * **au format**: partiellement pris en charge. Retourne la concaténation de champs **firstName** et **lastName** de BlackBerry.
+
+  * **familyName**: prise en charge. Stockée dans le champ **lastName** BlackBerry.
+
+  * **givenName**: prise en charge. Stockée dans le champ **firstName** BlackBerry.
+
+  * **middleName**: ne pas pris en charge, retour`null`.
+
+  * **honorificPrefix**: ne pas pris en charge, retour`null`.
+
+  * **honorificSuffix**: ne pas pris en charge, retour`null`.
+
+### Bizarreries de FirefoxOS
+
+  * **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### Notes au sujet d'iOS
+
+  * **au format**: partiellement pris en charge. Retourne la dénomination composée d'iOS, mais est en lecture seule.
+
+### Bizarreries de Windows 8
+
+  * **au format**: c'est le seul nom de propriété et est identique à `displayName` , et`nickname`
+
+  * **familyName**: non pris en charge
+
+  * **givenName**: non pris en charge
+
+  * **middleName**: non pris en charge
+
+  * **honorificPrefix**: non pris en charge
+
+  * **honorificSuffix**: non pris en charge
+
+### Bizarreries de Windows
+
+  * **mise en forme**: il est identique à`displayName`
+
+## ContactOrganization
+
+Le `ContactOrganization` objet Stocke des propriétés un contact de l'organisation. A `Contact` objet contient un ou plusieurs `ContactOrganization` des objets dans un tableau.
+
+### Propriétés
+
+  * **pref**: la valeur `true` si ce `ContactOrganization` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+  * **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. _(DOMString)
+
+  * **nom**: le nom de l'organisation. *(DOMString)*
+
+  * **Département**: le département et le contrat de travaille pour. *(DOMString)*
+
+  * **titre**: titre du contact auprès de l'organisation. *(DOMString)*
+
+### Plates-formes supportées
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 et 8
+  * Windows (Windows 8.1 et Windows Phone 8.1 dispositifs seulement)
+
+### Exemple
+
+    function onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + « \n » + "Type:" + contacts[i].organizations[j].type + « \n » + "nom:" + contacts[i].organizations[j].name + « \n » + "Département:" + contacts[i].organizations[j].department + « \n » + "Title: "+ contacts[i].organizations[j].title) ;
+            }
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    options de var = new ContactFindOptions() ;
+    options.Filter = "" ;
+    filtre = ["displayName", « organisations »] ;
+    Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+    
+
+### Android 2.X Quirks
+
+  * **pref**: ne pas pris en charge par des dispositifs Android 2.X, retour`false`.
+
+### BlackBerry 10 Quirks
+
+  * **pref**: ne pas pris en charge par les appareils BlackBerry, retour`false`.
+
+  * **type**: ne pas pris en charge par les appareils BlackBerry, retour`null`.
+
+  * **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ **company** de BlackBerry.
+
+  * **Département**: ne pas pris en charge, retour`null`.
+
+  * **titre**: partiellement pris en charge. Le premier titre de l'organisation est stocké dans le champ de **jobTitle** BlackBerry.
+
+### Firefox OS Quirks
+
+  * **pref**: non pris en charge
+
+  * **type**: non pris en charge
+
+  * **Département**: non pris en charge
+
+  * Les champs **nom** et **titre** stocké dans **org** et **jobTitle**.
+
+### Notes au sujet d'iOS
+
+  * **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+  * **type**: non pris en charge sur les appareils iOS, retour`null`.
+
+  * **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ de **kABPersonOrganizationProperty** iOS.
+
+  * **Département**: partiellement pris en charge. Le premier nom de département est stocké dans le champ de **kABPersonDepartmentProperty** iOS.
+
+  * **titre**: partiellement pris en charge. Le premier titre est stocké dans le champ de **kABPersonJobTitleProperty** iOS.
+
+### Bizarreries de Windows
+
+  * **pref**: ne pas pris en charge, retour`false`.
+
+  * **type**: ne pas pris en charge, retour`null`.

km0App/node_modules/cordova-plugin-contacts/doc/fr/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+Ce plugin définit un global `navigator.contacts` objet, ce qui permet d'accéder à la base de données de contacts de dispositif.
+
+Bien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.
+
+    document.addEventListener (« deviceready », onDeviceReady, false) ;
+    function onDeviceReady() {console.log(navigator.contacts);}
+    
+
+**Avertissement**: collecte et utilisation des données de contact soulève des questions importantes de la vie privée. Politique de confidentialité de votre application doit examiner comment l'application utilise les données de contact et si il est partagé avec d'autres parties. Information de contact est considéré comme sensible parce qu'il révèle les gens avec lesquels une personne communique. Par conséquent, en plus de la politique de confidentialité de l'application, vous devez envisager fortement fournissant un avis juste-à-temps, avant que l'application accède ou utilise des données de contact, si le système d'exploitation de périphérique ne fait donc pas déjà. Cet avis doit fournir les mêmes renseignements susmentionnées, ainsi que d'obtenir l'autorisation de l'utilisateur (par exemple, en présentant des choix **OK** et **Non merci**). Notez que certains marchés app peuvent exiger l'application de fournir un avis juste-à-temps et obtenir la permission de l'utilisateur avant d'accéder à des données de contact. Une expérience utilisateur claire et facile à comprendre qui entourent l'utilisation de données permettent d'éviter la confusion des utilisateurs de contact et une utilisation jugée abusive des données de contact. Pour plus d'informations, consultez le Guide de la vie privée.
+
+## Installation
+
+    Cordova plugin ajouter cordova-plugin-contacts
+    
+
+### Firefox OS Quirks
+
+Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste][1]. Ajouter permisions pertinentes. Il est également nécessaire de changer le type d'application Web de « privilégiés » - [Docs manifeste][2]. **Avertissement**: toutes les applications privilégiées appliquer [Contenu politique de sécurité][3] qui interdit à un script inline. Initialiser votre application d'une autre manière.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    « type »: "le privilège", "autorisations": {« contacts »: {« accès »: "readwrite", "description": "décrire pourquoi il est nécessaire pour obtenir cette permission"}}
+    
+
+### Bizarreries de Windows
+
+Contacts éventuellement retournés par `find` et `pickContact` méthodes sont en lecture seule, afin que votre application ne puisse les modifier. `find`méthode disponible uniquement sur les appareils Windows Phone 8.1.
+
+### Bizarreries de Windows 8
+
+Windows 8 Contacts sont en lecture seule. Via les Contacts d'API Cordova ne sont pas queryable/consultables, vous devez en informer l'utilisateur de choisir un contact comme un appel à contacts.pickContact qui va ouvrir l'application « People » où l'utilisateur doit choisir un contact. Les contacts retournés sont en lecture seule, afin que votre application ne puisse les modifier.
+
+## Navigator.contacts
+
+### Méthodes
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Objets
+
+*   Contact
+*   ContactName
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## Navigator.contacts.Create
+
+La `navigator.contacts.create` méthode est synchrone et retourne un nouveau `Contact` objet.
+
+Cette méthode ne conserve pas l'objet de Contact dans la base de données des contacts périphériques, dont vous avez besoin d'appeler le `Contact.save` méthode.
+
+### Plates-formes prises en charge
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+
+### Exemple
+
+    myContact var = navigator.contacts.create ({« displayName »: « Test User »}) ;
+    
+
+## navigator.contacts.find
+
+La `navigator.contacts.find` méthode s'exécute de façon asynchrone, l'interrogation de la base de données de contacts de dispositif et retourne un tableau de `Contact` objets. Les objets résultants sont passés à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+Le paramètre **contactFields** spécifie les champs à utiliser comme un qualificateur de recherche. Un paramètre de longueur nulle **contactFields** n'est pas valide et se traduit par `ContactError.INVALID_ARGUMENT_ERROR` . Une valeur de **contactFields** de `"*"` recherche dans les champs de tout contact.
+
+La chaîne **contactFindOptions.filter** peut servir comme un filtre de recherche lors de l'interrogation de la base de données de contacts. Si fourni, un non-respect de la casse, correspondance de valeur partielle est appliquée à chaque champ spécifié dans le paramètre **contactFields** . S'il y a une correspondance pour *n'importe quel* des champs spécifiés, le contact est retourné. Utilisation **contactFindOptions.desiredFields** paramètre de contrôle qui contacter propriétés doit être retourné au retour.
+
+### Paramètres
+
+*   **contactFields**: communiquer avec les champs à utiliser comme un qualificateur de recherche. *(DOMString[])* [Required]
+
+*   **contactSuccess**: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Required]
+
+*   **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Optional]
+
+*   **contactFindOptions**: recherche d'options pour filtrer navigator.contacts. [Optional]
+    
+    Clés incluent :
+    
+    *   **filtre**: la chaîne de recherche utilisée pour trouver navigator.contacts. *(DOMString)* (Par défaut :`""`)
+    
+    *   **multiples**: détermine si l'opération find retourne plusieurs navigator.contacts. *(Booléen)* (Par défaut :`false`)
+        
+        *   **desiredFields**: Contactez champs soit retourné en arrière. Si spécifié, l'entraînant `Contact` objet dispose seulement des valeurs de ces champs. *(DOMString[])* [Optional]
+
+### Plates-formes prises en charge
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+*   Windows (Windows Phone 8.1 dispositifs seulement)
+
+### Exemple
+
+    function onSuccess(contacts) {alert (« Found » + contacts.length + « contacts. »);} ;
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    trouver tous les contacts avec « Bob » dans toute option de var de champ nom = new ContactFindOptions() ;
+    options.Filter = « Bob » ;
+    options.multiple = true ;
+    options.desiredFields = [navigator.contacts.fieldType.id] ;
+    champs var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name] ;
+    Navigator.contacts.Find (champs, onSuccess, onError, options) ;
+    
+
+### Bizarreries de Windows
+
+*   `__contactFields__`n'est pas prise en charge et sera ignorée. `find`méthode toujours tenter de faire correspondre le nom, adresse e-mail ou numéro de téléphone d'un contact.
+
+## navigator.contacts.pickContact
+
+La `navigator.contacts.pickContact` méthode lance le sélecteur de Contact pour sélectionner un contact unique. L'objet qui en résulte est passé à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+### Paramètres
+
+*   **contactSuccess**: fonction de rappel de succès appelée avec l'objet de Contact unique. [Obligatoire]
+
+*   **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+### Plates-formes prises en charge
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### Exemple
+
+    navigator.contacts.pickContact(function(contact) {console.log ("le contact suivant a été retenu:" + JSON.stringify(contact)) ;
+        }, function(err) {console.log ("Error:" + err) ;
+        });
+    
+
+## Contact
+
+Le `Contact` objet représente le contact de l'utilisateur. Contacts peuvent être créés, conservés ou supprimés de la base de données de contacts de dispositif. Contacts peuvent également être récupérées (individuellement ou en vrac) de la base de données en appelant le `navigator.contacts.find` méthode.
+
+**NOTE**: tous les champs de contact susmentionnés ne sont pris en charge sur chaque plate-forme de périphérique. S'il vous plaît vérifier la section *bizarreries* de chaque plate-forme pour plus de détails.
+
+### Propriétés
+
+*   **ID**: un identificateur global unique. *(DOMString)*
+
+*   **displayName**: le nom de ce Contact, approprié pour l'affichage à l'utilisateur final. *(DOMString)*
+
+*   **nom**: un objet contenant tous les composants d'un nom de personnes. *(ContactName)*
+
+*   **Pseudo**: un nom occasionnel permettant de régler le contact. *(DOMString)*
+
+*   **phoneNumbers**: un tableau des numéros de téléphone du contact. *(ContactField[])*
+
+*   **courriels**: un tableau d'adresses de courriel du contact. *(ContactField[])*
+
+*   **adresses**: un tableau d'adresses tous les contacts. *(ContactAddress[])*
+
+*   **IMS**: un tableau d'adresses IM tout le contact. *(ContactField[])*
+
+*   **organisations**: un tableau des organisations de tout le contact. *(ContactOrganization[])*
+
+*   **anniversaire**: l'anniversaire du contact. *(Date)*
+
+*   **Remarque**: une remarque sur le contact. *(DOMString)*
+
+*   **photos**: un tableau de photos du contact. *(ContactField[])*
+
+*   **catégories**: un tableau de toutes les catégories définies par l'utilisateur attribuée au contact. *(ContactField[])*
+
+*   **URL**: un tableau des pages web attribuée au contact. *(ContactField[])*
+
+### Méthodes
+
+*   **Clone**: retourne un nouveau `Contact` objet qui est une copie complète de l'objet appelant, avec le `id` propriété la valeur`null`.
+
+*   **supprimer**: supprime le contact de la base de données de contacts de dispositif, sinon exécute un rappel d'erreur avec un `ContactError` objet.
+
+*   **Enregistrer**: enregistre un nouveau contact dans la base de données de contacts de périphérique, ou met à jour un contact existant, si un contact avec le même **id** existe déjà.
+
+### Plates-formes prises en charge
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+*   Windows 8
+*   Windows
+
+### Enregistrez l'exemple
+
+    function onSuccess(contact) {alert ("sauver succès");} ;
+    
+    function onError(contactError) {alert ("erreur =" + contactError.code);} ;
+    
+    créer un objet contact contact var = navigator.contacts.create() ;
+    contact.displayName = « Plombier » ;
+    contact.Nickname = « Plombier » ;            spécifier à la fois pour prendre en charge tous les périphériques / / renseigner certains champs var nom = new ContactName() ;
+    name.givenName = « Jane » ;
+    name.familyName = « Doe » ;
+    contact.name = nom ;
+    
+    enregistrer dans contact.save(onSuccess,onError) de l'appareil ;
+    
+
+### Exemple de clone
+
+        Clone clone objet contact var = contact.clone() ;
+        clone.name.givenName = « John » ;
+        Console.log ("contact Original nom =" + contact.name.givenName) ;
+        Console.log ("nom de contact clonés =" + clone.name.givenName) ;
+    
+
+### Supprimer l'exemple
+
+    fonction onSuccess() {alert ("succès");} ;
+    
+    function onError(contactError) {alert ("erreur =" + contactError.code);} ;
+    
+    supprimer le contact de l'appareil contact.remove(onSuccess,onError) ;
+    
+
+### Android 2.X Quirks
+
+*   **catégories**: non pris en charge sur les périphériques Android 2.X, retour`null`.
+
+### BlackBerry 10 Quirks
+
+*   **ID**: assignés par l'appareil lors de l'enregistrement du contact.
+
+### Bizarreries de FirefoxOS
+
+*   **catégories**: partiellement pris en charge. Champs **pref** et **type** sont de retour`null`
+
+*   **IMS**: non pris en charge
+
+*   **photos**: ne pas pris en charge
+
+### iOS Quirks
+
+*   **displayName**: ne pas possible sur iOS, retour `null` à moins qu'il n'y a aucun `ContactName` spécifié, auquel cas, il renvoie le nom composite, **Pseudo** ou `""` , respectivement.
+
+*   **anniversaire**: doit être entré comme un JavaScript `Date` objet, de la même façon qu'il soit retourné.
+
+*   **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application. Contenu du répertoire temporaire est supprimés lorsque l'application se ferme.
+
+*   **catégories**: cette propriété n'est actuellement pas supportée, retour`null`.
+
+### Windows Phone 7 et 8 Quirks
+
+*   **displayName**: lorsque vous créez un contact, la valeur fournie pour le paramètre de nom d'affichage est différent de l'affichage nom Récupérée lors de la recherche du contact.
+
+*   **URL**: lorsque vous créez un contact, les utilisateurs peuvent entrer et enregistrer plus d'une adresse web, mais seulement un est disponible lors de la recherche du contact.
+
+*   **phoneNumbers**: l'option de *pref* n'est pas pris en charge. Le *type* n'est pas pris en charge lors d'une opération de *trouver* . Seul `phoneNumber` est autorisé pour chaque *type*.
+
+*   **courriels**: l'option de *pref* n'est pas pris en charge. Accueil et personnels références même courriel entrée. Une seule participation est autorisée pour chaque *type*.
+
+*   **adresses**: prend en charge seulement travail et accueil/personal *type*. La maison et personnels de *type* référence la même entrée d'adresse. Une seule participation est autorisée pour chaque *type*.
+
+*   **organisations**: seul est autorisé et ne supporte pas les attributs *pref*, *type*et *Département* .
+
+*   **Remarque**: ne pas pris en charge, retour`null`.
+
+*   **IMS**: ne pas pris en charge, retour`null`.
+
+*   **anniversaires**: ne pas pris en charge, retour`null`.
+
+*   **catégories**: ne pas pris en charge, retour`null`.
+
+### Bizarreries de Windows
+
+*   **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application.
+
+*   **anniversaires**: ne pas pris en charge, retour`null`.
+
+*   **catégories**: ne pas pris en charge, retour`null`.
+
+## ContactAddress
+
+Le `ContactAddress` objet Stocke les propriétés d'une seule adresse d'un contact. A `Contact` objet peut inclure plusieurs adresses dans un `ContactAddress[]` tableau.
+
+### Propriétés
+
+*   **pref**: la valeur `true` si ce `ContactAddress` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+*   **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
+
+*   **mise en forme**: l'adresse complète au format pour l'affichage. *(DOMString)*
+
+*   **adresse**: l'adresse complète. *(DOMString)*
+
+*   **localité**: la ville ou la localité. *(DOMString)*
+
+*   **région**: l'État ou la région. *(DOMString)*
+
+*   **Code postal**: le code zip ou code postal. *(DOMString)*
+
+*   **pays**: le nom du pays. *(DOMString)*
+
+### Plates-formes prises en charge
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+*   Windows 8
+*   Windows
+
+### Exemple
+
+    Affichez les informations d'adresse pour tous les contacts fonctionnent onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + « \n » + "Type:" + contacts[i].addresses[j].type + « \n » + "au format:" + contacts[i].addresses[j].formatted + « \n » + "adresse de rue: "+ contacts[i].addresses[j].streetAddress +"\n"+" localité: "+ contacts[i].addresses[j].locality +"\n"+" région: "+ contacts[i].addresses[j].region +"\n"+" Code Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" pays: "+ contacts[i].addresses[j].country) ;
+            }
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    trouver tous les contacts options var = new ContactFindOptions() ;
+    options.Filter = "" ;
+    filtre var = ["name", « adresses »] ;
+    Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+    
+
+### Android 2.X Quirks
+
+*   **pref**: ne pas pris en charge, retour `false` sur les appareils Android 2.X.
+
+### BlackBerry 10 Quirks
+
+*   **pref**: non pris en charge sur les appareils BlackBerry, retour`false`.
+
+*   **type**: partiellement pris en charge. Seule chaque de *travail* et tapez les adresses de *la maison* peut être stockée par contact.
+
+*   **au format**: partiellement pris en charge. Retourne la concaténation de tous les champs d'adresse BlackBerry.
+
+*   **streetAddress**: prise en charge. Retourne la concaténation de BlackBerry **address1** et **address2** champs d'adresse.
+
+*   **localité**: prise en charge. Stockée dans le champ d'adresse BlackBerry **ville** .
+
+*   **région**: pris en charge. Stockée dans le champ d'adresse BlackBerry **stateProvince** .
+
+*   **Code postal**: prise en charge. Stockée dans le champ d'adresse BlackBerry **zipPostal** .
+
+*   **pays**: prise en charge.
+
+### Bizarreries de FirefoxOS
+
+*   **au format**: actuellement ne pas pris en charge
+
+### iOS Quirks
+
+*   **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+*   **au format**: actuellement ne pas pris en charge.
+
+### Bizarreries de Windows 8
+
+*   **pref**: non pris en charge
+
+### Bizarreries de Windows
+
+*   **pref**: non pris en charge
+
+## ContactError
+
+Le `ContactError` objet est retourné à l'utilisateur via le `contactError` fonction de rappel lorsqu'une erreur survient.
+
+### Propriétés
+
+*   **code**: l'un des codes d'erreur prédéfinis énumérés ci-dessous.
+
+### Constantes
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Le `ContactField` objet est un composant réutilisable que représente contacter champs génériquement. Chaque `ContactField` objet contient un `value` , `type` , et `pref` propriété. A `Contact` objet stocke plusieurs propriétés dans `ContactField[]` tableaux, tels que téléphone numéros et adresses e-mail.
+
+Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour une `ContactField` l'attribut **type** de l'objet. Par exemple, un numéro de téléphone peut spécifier des valeurs de **type** de la *maison*, *travail*, *mobile*, *iPhone*ou toute autre valeur qui est pris en charge par la base de contacts de la plate-forme un périphérique particulier. Toutefois, pour les `Contact` **photos** champ, le champ **type** indique le format de l'image retournée : **url** lorsque l'attribut **value** contient une URL vers l'image photo ou *base64* lorsque la **valeur** contient une chaîne codée en base64 image.
+
+### Propriétés
+
+*   **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
+
+*   **valeur**: la valeur du champ, comme un téléphone numéro ou adresse e-mail. *(DOMString)*
+
+*   **pref**: la valeur `true` si ce `ContactField` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+### Plates-formes prises en charge
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+*   Windows 8
+*   Windows
+
+### Exemple
+
+        créer un nouveau contact contact var = navigator.contacts.create() ;
+    
+        stocker des numéros de téléphone de contact en ContactField [] var phoneNumbers = [] ;
+        phoneNumbers[0] = new ContactField (« travail », ' 212-555-1234', false) ;
+        phoneNumbers[1] = new ContactField (« mobile », ' 917-555-5432', true) ; phoneNumbers[2] numéro préféré = new ContactField (« home », ' 203-555-7890', false) ;
+        contact.phoneNumbers = phoneNumbers ;
+    
+        enregistrer le contact contact.save() ;
+    
+
+### Quirks Android
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
+### BlackBerry 10 Quirks
+
+*   **type**: partiellement pris en charge. Utilisé pour les numéros de téléphone.
+
+*   **valeur**: prise en charge.
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
+### iOS Quirks
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
+### Quirks Windows8
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
+### Bizarreries de Windows
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
+## ContactName
+
+Contient différents types d'informations sur un `Contact` nom de l'objet.
+
+### Propriétés
+
+*   **mise en forme**: le nom complet du contact. *(DOMString)*
+
+*   **familyName**: nom de famille du contact. *(DOMString)*
+
+*   **givenName**: prénom du contact. *(DOMString)*
+
+*   **middleName**: deuxième prénom du contact. *(DOMString)*
+
+*   **honorificPrefix**: préfixe du contact (exemple *M.* ou *Mme*) *(DOMString)*
+
+*   **honorificSuffix**: suffixe du contact (exemple *Esq.*). *(DOMString)*
+
+### Plates-formes prises en charge
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+*   Windows 8
+*   Windows
+
+### Exemple
+
+    function onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {alert ("Formatted:" + contacts[i].name.formatted + « \n » + "patronyme:" + contacts[i].name.familyName + « \n » + "Prénom:" + contacts[i].name.givenName + « \n » + "Prénom:" + contacts[i].name.middleName + « \n » + "suffixe:" + contacts[i].name.honorificSuffix + « \n » + "préfixe:" + contacts[i].name.honorificSuffix) ;
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    options de var = new ContactFindOptions() ;
+    options.Filter = "" ;
+    filtre = ["name", « nom »] ;
+    Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+    
+
+### Quirks Android
+
+*   **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### BlackBerry 10 Quirks
+
+*   **au format**: partiellement pris en charge. Retourne la concaténation de champs **firstName** et **lastName** de BlackBerry.
+
+*   **familyName**: prise en charge. Stockée dans le champ **lastName** BlackBerry.
+
+*   **givenName**: prise en charge. Stockée dans le champ **firstName** BlackBerry.
+
+*   **middleName**: ne pas pris en charge, retour`null`.
+
+*   **honorificPrefix**: ne pas pris en charge, retour`null`.
+
+*   **honorificSuffix**: ne pas pris en charge, retour`null`.
+
+### Bizarreries de FirefoxOS
+
+*   **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### iOS Quirks
+
+*   **au format**: partiellement pris en charge. Retourne la dénomination composée d'iOS, mais est en lecture seule.
+
+### Bizarreries de Windows 8
+
+*   **au format**: c'est le seul nom de propriété et est identique à `displayName` , et`nickname`
+
+*   **familyName**: non pris en charge
+
+*   **givenName**: non pris en charge
+
+*   **middleName**: non pris en charge
+
+*   **honorificPrefix**: non pris en charge
+
+*   **honorificSuffix**: non pris en charge
+
+### Bizarreries de Windows
+
+*   **mise en forme**: il est identique à`displayName`
+
+## ContactOrganization
+
+Le `ContactOrganization` objet Stocke des propriétés un contact de l'organisation. A `Contact` objet contient un ou plusieurs `ContactOrganization` des objets dans un tableau.
+
+### Propriétés
+
+*   **pref**: la valeur `true` si ce `ContactOrganization` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+*   **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. _(DOMString)
+
+*   **nom**: le nom de l'organisation. *(DOMString)*
+
+*   **Département**: le département et le contrat de travaille pour. *(DOMString)*
+
+*   **titre**: titre du contact auprès de l'organisation. *(DOMString)*
+
+### Plates-formes prises en charge
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 et 8
+*   Windows (Windows 8.1 et Windows Phone 8.1 dispositifs seulement)
+
+### Exemple
+
+    function onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + « \n » + "Type:" + contacts[i].organizations[j].type + « \n » + "nom:" + contacts[i].organizations[j].name + « \n » + "Département:" + contacts[i].organizations[j].department + « \n » + "Title: "+ contacts[i].organizations[j].title) ;
+            }
+        }
+    };
+    
+    function onError(contactError) {alert('onError!');} ;
+    
+    options de var = new ContactFindOptions() ;
+    options.Filter = "" ;
+    filtre = ["displayName", « organisations »] ;
+    Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+    
+
+### Android 2.X Quirks
+
+*   **pref**: ne pas pris en charge par des dispositifs Android 2.X, retour`false`.
+
+### BlackBerry 10 Quirks
+
+*   **pref**: ne pas pris en charge par les appareils BlackBerry, retour`false`.
+
+*   **type**: ne pas pris en charge par les appareils BlackBerry, retour`null`.
+
+*   **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ **company** de BlackBerry.
+
+*   **Département**: ne pas pris en charge, retour`null`.
+
+*   **titre**: partiellement pris en charge. Le premier titre de l'organisation est stocké dans le champ de **jobTitle** BlackBerry.
+
+### Firefox OS Quirks
+
+*   **pref**: non pris en charge
+
+*   **type**: non pris en charge
+
+*   **Département**: non pris en charge
+
+*   Les champs **nom** et **titre** stocké dans **org** et **jobTitle**.
+
+### iOS Quirks
+
+*   **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+*   **type**: non pris en charge sur les appareils iOS, retour`null`.
+
+*   **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ de **kABPersonOrganizationProperty** iOS.
+
+*   **Département**: partiellement pris en charge. Le premier nom de département est stocké dans le champ de **kABPersonDepartmentProperty** iOS.
+
+*   **titre**: partiellement pris en charge. Le premier titre est stocké dans le champ de **kABPersonJobTitleProperty** iOS.
+
+### Bizarreries de Windows
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
+*   **type**: ne pas pris en charge, retour`null`.

km0App/node_modules/cordova-plugin-contacts/doc/it/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Questo plugin definisce un oggetto globale `navigator.contacts`, che fornisce l'accesso al database di contatti del dispositivo.
+
+Anche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**Avviso**: raccolta e utilizzo dei dati di contatto solleva questioni di privacy importante. Politica sulla privacy dell'app dovrebbe discutere come app utilizza i dati di contatto e se è condiviso con altre parti. Informazioni di contatto sono considerate sensibile perché rivela le persone con cui una persona comunica. Pertanto, oltre alla politica di privacy dell'app, è fortemente consigliabile fornendo un preavviso di just-in-time prima app accede o utilizza i dati di contatto, se il sistema operativo del dispositivo non farlo già. Tale comunicazione deve fornire le informazioni stesse notate sopra, oltre ad ottenere l'autorizzazione (ad esempio, presentando scelte per **OK** e **No grazie**). Si noti che alcuni mercati app possono richiedere l'app per fornire un preavviso di just-in-time e ottenere l'autorizzazione dell'utente prima di accedere ai dati di contatto. Un'esperienza utente chiara e facile--capisce che circonda l'uso del contatto dati aiuta a evitare la confusione dell'utente e percepito un uso improprio dei dati di contatto. Per ulteriori informazioni, vedere la guida sulla Privacy.
+
+## Installazione
+
+Ciò richiede cordova 5.0 + (v 1.0.0 stabile corrente)
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+Versioni precedenti di cordova comunque possono installare tramite l'id **deprecato** (stantio v0.2.16)
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+È anche possibile installare direttamente tramite url di repo (instabile)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### Firefox OS stranezze
+
+Creare **www/manifest.webapp** come descritto nel [Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest). Aggiungi permisions rilevanti. C'è anche la necessità di modificare il tipo di webapp in "privilegiato" - [Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type). **AVVERTENZA**: tutte le apps privilegiato applicare [Content Security Policy](https://developer.mozilla.org/en-US/Apps/CSP) che vieta script inline. Inizializzare l'applicazione in un altro modo.
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Stranezze di Windows
+
+**Prima del Windows 10:** Eventuali contatti restituiti dai metodi `trovare` e `pickContact` sono readonly, quindi l'applicazione non può modificarli. Metodo `find` disponibile solo sui dispositivi Windows Phone 8.1.
+
+**Windows 10 e sopra:** Contatti possono essere salvati e deposito di app locale contatti verranno salvate. Contatti possono anche essere eliminati.
+
+### Stranezze di Windows 8
+
+Windows 8 contatti sono readonly. Tramite i contatti di Cordova API non sono queryable/ricerche, si dovrebbe informare l'utente di scegliere un contatto come una chiamata a contacts.pickContact che aprirà l'app 'Persone' dove l'utente deve scegliere un contatto. Eventuali contatti restituiti sono readonly, quindi l'applicazione non può modificarli.
+
+## Navigator.contacts
+
+### Metodi
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### Oggetti
+
+  * Contact
+  * ContactName
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+Il metodo `navigator.contacts.create` è sincrono e restituisce un nuovo oggetto di `Contact`.
+
+Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il metodo `Contact.save`.
+
+### Piattaforme supportate
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+
+### Esempio
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Il metodo `navigator.contacts.find` in modo asincrono, esegue una query sul database di contatti del dispositivo e restituisce una matrice di oggetti `Contact`. Gli oggetti risultanti vengono passati alla funzione di callback `contactSuccess` specificata dal parametro **contactSuccess**.
+
+Il parametro **contactFields** specifica i campi per essere utilizzato come un qualificatore di ricerca. Un parametro di lunghezza zero, **contactFields** non è valido e si traduce in `ContactError.INVALID_ARGUMENT_ERROR`. Un valore di **contactFields** di `"*"` ricerche campi tutti i contatti.
+
+La stringa di **contactFindOptions.filter** può essere utilizzata come un filtro di ricerca quando una query sul database di contatti. Se fornito, una distinzione, corrispondenza parziale valore viene applicato a ogni campo specificato nel parametro **contactFields**. Se esiste una corrispondenza per *qualsiasi* dei campi specificati, viene restituito il contatto. Uso **contactFindOptions.desiredFields** parametro di controllo quale contattare la proprietà deve essere rispedito indietro.
+
+### Parametri
+
+  * **contactFields**: contattare campi da utilizzare come un qualificatore di ricerca. *(DOMString[])* [Required]
+
+  * **contactSuccess**: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Required]
+
+  * **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+  * **contactFindOptions**: opzioni per filtrare navigator.contacts di ricerca. [Optional]
+    
+    I tasti sono:
+    
+      * **filter**: la stringa di ricerca utilizzata per trovare navigator.contacts. *(DOMString)* (Default: `""`)
+    
+      * **multiple**: determina se l'operazione di ricerca restituisce più navigator.contacts. *(Boolean)* (Default: `false`)
+        
+          * **desiredFields**: contattare i campi per essere tornato indietro. Se specificato, il risultante `contatto` oggetto solo caratteristiche valori per questi campi. *(DOMString[])* [Optional]
+
+### Piattaforme supportate
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+  * Windows (Windows Phone 8.1 e Windows 10)
+
+### Esempio
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Stranezze di Windows
+
+  * `__contactFields__`non è supportato, verrà ignorato. `find`metodo cercherà sempre di abbinare il nome, indirizzo email o numero di telefono di un contatto.
+
+## navigator.contacts.pickContact
+
+Il metodo `navigator.contacts.pickContact` lancia il contatto selettore per selezionare un singolo contatto. L'oggetto risultante viene passato alla funzione di callback `contactSuccess` specificata dal parametro **contactSuccess**.
+
+### Parametri
+
+  * **contactSuccess**: funzione di callback di successo viene richiamato con il singolo oggetto di contatto. [Richiesto]
+
+  * **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+### Piattaforme supportate
+
+  * Android
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### Esempio
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Contact
+
+L'oggetto `Contact` rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il metodo `navigator.contacts.find`.
+
+**Nota**: non tutti i campi di contatto sopra elencati sono supportati su ogni piattaforma del dispositivo. Consultare la sezione di *stranezze* su ogni piattaforma per dettagli.
+
+### Proprietà
+
+  * **ID**: un identificatore univoco globale. *(DOMString)*
+
+  * **displayName**: il nome di questo contatto, adatto per la visualizzazione a utenti finali. *(DOMString)*
+
+  * **nome**: un oggetto che contiene tutti i componenti di un nome di persone. *(ContactName)*
+
+  * **Nickname**: un nome informale con cui affrontare il contatto. *(DOMString)*
+
+  * **phoneNumbers**: una matrice di numeri di telefono del contatto. *(ContactField[])*
+
+  * **email**: una matrice di indirizzi di posta elettronica del contatto. *(ContactField[])*
+
+  * **indirizzi**: una matrice di indirizzi di contatto. *(ContactAddress[])*
+
+  * **IMS**: una matrice di indirizzi IM tutto il contatto. *(ContactField[])*
+
+  * **organizzazioni**: una matrice di organizzazioni di tutto il contatto. *(ContactOrganization[])*
+
+  * **compleanno**: il compleanno del contatto. *(Data)*
+
+  * **Nota**: una nota sul contatto. *(DOMString)*
+
+  * **foto**: una matrice di foto del contatto. *(ContactField[])*
+
+  * **categorie**: matrice di tutte le categorie definite dall'utente connesso con il contatto. *(ContactField[])*
+
+  * **URL**: matrice di pagine web connesso con il contatto. *(ContactField[])*
+
+### Metodi
+
+  * **clone**: restituisce una nuova `Contact` oggetto che è una copia completa dell'oggetto chiamante, con la `id` proprietà impostata`null`.
+
+  * **rimuovere**: rimuove il contatto dal database contatti dispositivo, altrimenti esegue un callback di errore con un `ContactError` oggetto.
+
+  * **Salva**: salva un nuovo contatto nel database di contatti del dispositivo, o aggiorna un contatto esistente se esiste già un contatto con lo stesso **id** .
+
+### Piattaforme supportate
+
+  * Amazon fuoco OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+  * Windows 8
+  * Windows
+
+### Esempio di salvare
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Esempio di clone
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Rimuovere esempio
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Stranezze di Android 2. x
+
+  * **categorie**: non è supportato sui dispositivi Android 2. x, restituendo`null`.
+
+### BlackBerry 10 capricci
+
+  * **ID**: assegnate dal dispositivo quando si salva il contatto.
+
+### Capricci di FirefoxOS
+
+  * **categorie**: parzialmente supportati. Campi **pref** e **tipo** stanno tornando`null`
+
+  * **IMS**: non supportato
+
+  * **foto**: non supportato
+
+### iOS stranezze
+
+  * **displayName**: non supportata su iOS, tornando `null` se non c'è nessun `ContactName` specificato, nel qual caso restituisce il nome composito, **soprannome** o `""` , rispettivamente.
+
+  * **compleanno**: deve essere inserito come un JavaScript `Date` oggetto, allo stesso modo viene restituito.
+
+  * **foto**: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione. Contenuto della directory temporanea vengono rimossi quando l'applicazione termina.
+
+  * **categorie**: questa proprietà non è attualmente supportata, restituendo`null`.
+
+### Windows Phone 7 e 8 stranezze
+
+  * **displayName**: quando si crea un contatto, il valore specificato per il parametro del nome di visualizzazione è diverso dal nome visualizzato Estratto quando trovare il contatto.
+
+  * **URL**: quando si crea un contatto, gli utenti possono inserire e salvare più di un indirizzo web, ma solo uno è disponibile durante la ricerca del contatto.
+
+  * **phoneNumbers**: non è supportata l'opzione *pref* . Il *tipo* non è supportato in un'operazione di *trovare* . Un solo `phoneNumber` è consentita per ogni *tipo*.
+
+  * **email**: non è supportata l'opzione *pref* . Home e personal fa riferimento la stessa voce di posta elettronica. È consentito un solo ingresso per ogni *tipo*.
+
+  * **indirizzi**: supporta solo lavoro e casa/personali *tipo*. Il riferimento principale e personale *tipo* la stessa voce di indirizzo. È consentito un solo ingresso per ogni *tipo*.
+
+  * **organizzazioni**: solo uno è consentito e non supporta gli attributi *pref*, *tipo*e *dipartimento* .
+
+  * **Nota**: non supportato, restituendo`null`.
+
+  * **IMS**: non supportato, restituendo`null`.
+
+  * **compleanni**: non supportato, restituendo`null`.
+
+  * **categorie**: non supportato, restituendo`null`.
+
+  * **remove**: metodo non è supportato
+
+### Stranezze di Windows
+
+  * **foto**: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione.
+
+  * **compleanni**: non supportato, restituendo`null`.
+
+  * **categorie**: non supportato, restituendo`null`.
+
+  * **remove**: metodo è supportato solo in Windows 10 o superiore.
+
+## ContactAddress
+
+L'oggetto `ContactAddress` memorizza le proprietà di un singolo indirizzo di un contatto. Un oggetto `Contact` può includere più di un indirizzo in una matrice `[] ContactAddress`.
+
+### Proprietà
+
+  * **pref**: impostare su `true` se questo `ContactAddress` contiene il valore dell'utente preferito. *(booleano)*
+
+  * **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+  * **formattato**: indirizzo completo formattato per la visualizzazione. *(DOMString)*
+
+  * **streetAddress**: l'indirizzo completo. *(DOMString)*
+
+  * **località**: la città o località. *(DOMString)*
+
+  * **regione**: lo stato o la regione. *(DOMString)*
+
+  * **postalCode**: il codice postale o il codice postale. *(DOMString)*
+
+  * **paese**: il nome del paese. *(DOMString)*
+
+### Piattaforme supportate
+
+  * Amazon fuoco OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+  * Windows 8
+  * Windows
+
+### Esempio
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze di Android 2. x
+
+  * **pref**: non supportato, tornando `false` su dispositivi Android 2. x.
+
+### BlackBerry 10 capricci
+
+  * **pref**: non è supportato sui dispositivi BlackBerry, restituendo`false`.
+
+  * **tipo**: parzialmente supportati. Solo uno di *lavoro* e *casa* tipo indirizzi può essere memorizzato per ciascun contatto.
+
+  * **formattato**: parzialmente supportati. Restituisce una concatenazione di tutti i campi Indirizzo BlackBerry.
+
+  * **streetAddress**: supportato. Restituisce una concatenazione di BlackBerry **Indirizzo1** e **Indirizzo2** campi indirizzo.
+
+  * **località**: supportato. Memorizzato nel campo indirizzo **città** di BlackBerry.
+
+  * **regione**: supportato. Memorizzato nel campo indirizzo di **stateProvince** BlackBerry.
+
+  * **postalCode**: supportato. Memorizzato nel campo dell'indirizzo **zipPostal** BlackBerry.
+
+  * **paese**: supportato.
+
+### Capricci di FirefoxOS
+
+  * **formattato**: attualmente non supportato
+
+### iOS stranezze
+
+  * **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+  * **formattato**: attualmente non supportati.
+
+### Stranezze di Windows 8
+
+  * **pref**: non supportato
+
+### Stranezze di Windows
+
+  * **pref**: non supportato
+
+## ContactError
+
+L'oggetto `ContactError` viene restituito all'utente tramite la funzione di callback `contactError` quando si verifica un errore.
+
+### Proprietà
+
+  * **codice**: uno dei codici di errore predefiniti elencati di seguito.
+
+### Costanti
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+L'oggetto `ContactField` è un componente riutilizzabile che rappresenta Contatta campi genericamente. Ogni oggetto `ContactField` contiene una proprietà di `value`, `type` e `pref`. Un oggetto `Contact` memorizza diverse proprietà in matrici `[] ContactField`, come numeri di telefono e indirizzi email.
+
+Nella maggior parte dei casi, esistono pre-determinati valori per l'attributo `type` di un oggetto **ContactField**. Ad esempio, un numero di telefono può specificare valori di **type** di *casa*, *lavoro*, *mobile*, *iPhone* o qualsiasi altro valore che è supportato dal database dei contatti su una piattaforma particolare dispositivo. Tuttavia, per il campo di **photo** del `Contacto`, il campo **type** indica il formato dell'immagine restituita: **url** quando il **value** di attributo contiene un URL per l'immagine fotografica, o *base64*, quando il **value** contiene una stringa con codifica base64 immagine.
+
+### Proprietà
+
+  * **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+  * **valore**: il valore del campo, ad esempio un telefono numero o indirizzo e-mail. *(DOMString)*
+
+  * **pref**: impostare su `true` se questo `ContactField` contiene il valore dell'utente preferito. *(booleano)*
+
+### Piattaforme supportate
+
+  * Amazon fuoco OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+  * Windows 8
+  * Windows
+
+### Esempio
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Stranezze Android
+
+  * **pref**: non supportato, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+  * **tipo**: parzialmente supportati. Usato per i numeri di telefono.
+
+  * **valore**: supportato.
+
+  * **pref**: non supportato, restituendo`false`.
+
+### iOS stranezze
+
+  * **pref**: non supportato, restituendo`false`.
+
+### Stranezze di Windows8
+
+  * **pref**: non supportato, restituendo`false`.
+
+### Stranezze di Windows
+
+  * **pref**: non supportato, restituendo`false`.
+
+## ContactName
+
+Contiene diversi tipi di informazioni sul nome di un oggetto `Contact`.
+
+### Proprietà
+
+  * **formattato**: il nome completo del contatto. *(DOMString)*
+
+  * **familyName**: cognome del contatto. *(DOMString)*
+
+  * **givenName**: nome del contatto. *(DOMString)*
+
+  * **middleName**: il nome del contatto medio. *(DOMString)*
+
+  * **honorificPrefix**: prefisso del contatto (esempio *Mr* o *Dr*) *(DOMString)*
+
+  * **honorificSuffix**: suffisso del contatto (esempio *Esq.*). *(DOMString)*
+
+### Piattaforme supportate
+
+  * Amazon fuoco OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+  * Windows 8
+  * Windows
+
+### Esempio
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze Android
+
+  * **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### BlackBerry 10 capricci
+
+  * **formattato**: parzialmente supportati. Restituisce una concatenazione di campi **firstName** e **lastName** BlackBerry.
+
+  * **familyName**: supportato. Archiviato in campo **lastName** BlackBerry.
+
+  * **givenName**: supportato. Archiviato in campo **firstName** BlackBerry.
+
+  * **middleName**: non supportato, restituendo`null`.
+
+  * **honorificPrefix**: non supportato, restituendo`null`.
+
+  * **honorificSuffix**: non supportato, restituendo`null`.
+
+### Capricci di FirefoxOS
+
+  * **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### iOS stranezze
+
+  * **formattato**: parzialmente supportati. Restituisce il nome composito di iOS, ma è di sola lettura.
+
+### Stranezze di Windows 8
+
+  * **formattato**: questo è l'unico nome proprietà ed è identico a `displayName` , e`nickname`
+
+  * **familyName**: non supportato
+
+  * **givenName**: non supportato
+
+  * **middleName**: non supportato
+
+  * **honorificPrefix**: non supportato
+
+  * **honorificSuffix**: non supportato
+
+### Stranezze di Windows
+
+  * **formattato**: esso è identico al`displayName`
+
+## ContactOrganization
+
+L'oggetto `ContactOrganization` memorizza la proprietà di organizzazione di un contatto. Un oggetto `Contact` memorizza uno o più oggetti `ContactOrganization` in una matrice.
+
+### Proprietà
+
+  * **pref**: impostare su `true` se questo `ContactOrganization` contiene il valore dell'utente preferito. *(booleano)*
+
+  * **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. _(DOMString)
+
+  * **nome**: il nome dell'organizzazione. *(DOMString)*
+
+  * **dipartimento**: contratto lavora per il dipartimento. *(DOMString)*
+
+  * **titolo**: titolo del contatto presso l'organizzazione. *(DOMString)*
+
+### Piattaforme supportate
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 e 8
+  * Windows (solo dispositivi Windows 8.1 e 8.1 di Windows Phone)
+
+### Esempio
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze di Android 2. x
+
+  * **pref**: non supportato dai dispositivi Android 2. x, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+  * **pref**: non supportato dai dispositivi BlackBerry, restituendo`false`.
+
+  * **tipo**: non supportato dai dispositivi BlackBerry, restituendo`null`.
+
+  * **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **azienda** BlackBerry.
+
+  * **dipartimento**: non supportato, restituendo`null`.
+
+  * **titolo**: parzialmente supportati. Il primo titolo di organizzazione è memorizzato nel campo **jobTitle** BlackBerry.
+
+### Firefox OS stranezze
+
+  * **pref**: non supportato
+
+  * **tipo**: non supportato
+
+  * **dipartimento**: non supportato
+
+  * Campi **nome** e **titolo** memorizzato in **org** e **jobTitle**.
+
+### iOS stranezze
+
+  * **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+  * **tipo**: non è supportato sui dispositivi iOS, restituendo`null`.
+
+  * **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **kABPersonOrganizationProperty** iOS.
+
+  * **dipartimento**: parzialmente supportati. Il primo nome del dipartimento è memorizzato nel campo **kABPersonDepartmentProperty** iOS.
+
+  * **titolo**: parzialmente supportati. Il primo titolo è memorizzato nel campo **kABPersonJobTitleProperty** iOS.
+
+### Stranezze di Windows
+
+  * **pref**: non supportato, restituendo`false`.
+
+  * **tipo**: non supportato, restituendo`null`.

km0App/node_modules/cordova-plugin-contacts/doc/it/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+Questo plugin definisce un oggetto globale `navigator.contacts`, che fornisce l'accesso al database di contatti del dispositivo.
+
+Anche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**Avviso**: raccolta e utilizzo dei dati di contatto solleva questioni di privacy importante. Politica sulla privacy dell'app dovrebbe discutere come app utilizza i dati di contatto e se è condiviso con altre parti. Informazioni di contatto sono considerate sensibile perché rivela le persone con cui una persona comunica. Pertanto, oltre alla politica di privacy dell'app, è fortemente consigliabile fornendo un preavviso di just-in-time prima app accede o utilizza i dati di contatto, se il sistema operativo del dispositivo non farlo già. Tale comunicazione deve fornire le informazioni stesse notate sopra, oltre ad ottenere l'autorizzazione (ad esempio, presentando scelte per **OK** e **No grazie**). Si noti che alcuni mercati app possono richiedere l'app per fornire un preavviso di just-in-time e ottenere l'autorizzazione dell'utente prima di accedere ai dati di contatto. Un'esperienza utente chiara e facile--capisce che circonda l'uso del contatto dati aiuta a evitare la confusione dell'utente e percepito un uso improprio dei dati di contatto. Per ulteriori informazioni, vedere la guida sulla Privacy.
+
+## Installazione
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### Firefox OS stranezze
+
+Creare **www/manifest.webapp** come descritto nel [Manifest Docs][1]. Aggiungi permisions rilevanti. C'è anche la necessità di modificare il tipo di webapp in "privilegiato" - [Manifest Docs][2]. **AVVERTENZA**: tutte le apps privilegiato applicare [Content Security Policy][3] che vieta script inline. Inizializzare l'applicazione in un altro modo.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Stranezze di Windows
+
+Eventuali contatti restituiti dai metodi `find` e `pickContact` sono readonly, quindi l'applicazione non può modificarli. Metodo `find` disponibile solo sui dispositivi Windows Phone 8.1.
+
+### Stranezze di Windows 8
+
+Windows 8 contatti sono readonly. Tramite i contatti di Cordova API non sono queryable/ricerche, si dovrebbe informare l'utente di scegliere un contatto come una chiamata a contacts.pickContact che aprirà l'app 'Persone' dove l'utente deve scegliere un contatto. Eventuali contatti restituiti sono readonly, quindi l'applicazione non può modificarli.
+
+## Navigator.contacts
+
+### Metodi
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Oggetti
+
+*   Contact
+*   ContactName
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## navigator.contacts.create
+
+Il metodo `navigator.contacts.create` è sincrono e restituisce un nuovo oggetto di `Contact`.
+
+Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il metodo `Contact.save`.
+
+### Piattaforme supportate
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+
+### Esempio
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Il metodo `navigator.contacts.find` in modo asincrono, esegue una query sul database di contatti del dispositivo e restituisce una matrice di oggetti `Contact`. Gli oggetti risultanti vengono passati alla funzione di callback `contactSuccess` specificata dal parametro **contactSuccess**.
+
+Il parametro **contactFields** specifica i campi per essere utilizzato come un qualificatore di ricerca. Un parametro di lunghezza zero, **contactFields** non è valido e si traduce in `ContactError.INVALID_ARGUMENT_ERROR`. Un valore di **contactFields** di `"*"` ricerche campi tutti i contatti.
+
+La stringa di **contactFindOptions.filter** può essere utilizzata come un filtro di ricerca quando una query sul database di contatti. Se fornito, una distinzione, corrispondenza parziale valore viene applicato a ogni campo specificato nel parametro **contactFields**. Se esiste una corrispondenza per *qualsiasi* dei campi specificati, viene restituito il contatto. Uso **contactFindOptions.desiredFields** parametro di controllo quale contattare la proprietà deve essere rispedito indietro.
+
+### Parametri
+
+*   **contactFields**: contattare campi da utilizzare come un qualificatore di ricerca. *(DOMString[])* [Required]
+
+*   **contactSuccess**: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Required]
+
+*   **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+*   **contactFindOptions**: opzioni per filtrare navigator.contacts di ricerca. [Optional]
+    
+    I tasti sono:
+    
+    *   **filter**: la stringa di ricerca utilizzata per trovare navigator.contacts. *(DOMString)* (Default: `""`)
+    
+    *   **multiple**: determina se l'operazione di ricerca restituisce più navigator.contacts. *(Boolean)* (Default: `false`)
+        
+        *   **desiredFields**: contattare i campi per essere tornato indietro. Se specificato, il risultante `contatto` oggetto solo caratteristiche valori per questi campi. *(DOMString[])* [Optional]
+
+### Piattaforme supportate
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows (solo per dispositivi Windows Phone 8.1)
+
+### Esempio
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Stranezze di Windows
+
+*   `__contactFields__`non è supportato, verrà ignorato. `find`metodo cercherà sempre di abbinare il nome, indirizzo email o numero di telefono di un contatto.
+
+## navigator.contacts.pickContact
+
+Il metodo `navigator.contacts.pickContact` lancia il contatto selettore per selezionare un singolo contatto. L'oggetto risultante viene passato alla funzione di callback `contactSuccess` specificata dal parametro **contactSuccess**.
+
+### Parametri
+
+*   **contactSuccess**: funzione di callback di successo viene richiamato con il singolo oggetto di contatto. [Richiesto]
+
+*   **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+### Piattaforme supportate
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### Esempio
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Contact
+
+L'oggetto `Contact` rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il metodo `navigator.contacts.find`.
+
+**Nota**: non tutti i campi di contatto sopra elencati sono supportati su ogni piattaforma del dispositivo. Consultare la sezione di *stranezze* su ogni piattaforma per dettagli.
+
+### Proprietà
+
+*   **ID**: un identificatore univoco globale. *(DOMString)*
+
+*   **displayName**: il nome di questo contatto, adatto per la visualizzazione a utenti finali. *(DOMString)*
+
+*   **nome**: un oggetto che contiene tutti i componenti di un nome di persone. *(ContactName)*
+
+*   **Nickname**: un nome informale con cui affrontare il contatto. *(DOMString)*
+
+*   **phoneNumbers**: una matrice di numeri di telefono del contatto. *(ContactField[])*
+
+*   **email**: una matrice di indirizzi di posta elettronica del contatto. *(ContactField[])*
+
+*   **indirizzi**: una matrice di indirizzi di contatto. *(ContactAddress[])*
+
+*   **IMS**: una matrice di indirizzi IM tutto il contatto. *(ContactField[])*
+
+*   **organizzazioni**: una matrice di organizzazioni di tutto il contatto. *(ContactOrganization[])*
+
+*   **compleanno**: il compleanno del contatto. *(Data)*
+
+*   **Nota**: una nota sul contatto. *(DOMString)*
+
+*   **foto**: una matrice di foto del contatto. *(ContactField[])*
+
+*   **categorie**: matrice di tutte le categorie definite dall'utente connesso con il contatto. *(ContactField[])*
+
+*   **URL**: matrice di pagine web connesso con il contatto. *(ContactField[])*
+
+### Metodi
+
+*   **clone**: restituisce una nuova `Contact` oggetto che è una copia completa dell'oggetto chiamante, con la `id` proprietà impostata`null`.
+
+*   **rimuovere**: rimuove il contatto dal database contatti dispositivo, altrimenti esegue un callback di errore con un `ContactError` oggetto.
+
+*   **Salva**: salva un nuovo contatto nel database di contatti del dispositivo, o aggiorna un contatto esistente se esiste già un contatto con lo stesso **id** .
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+*   Windows
+
+### Esempio di salvare
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Esempio di clone
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Rimuovere esempio
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Stranezze di Android 2. x
+
+*   **categorie**: non è supportato sui dispositivi Android 2. x, restituendo`null`.
+
+### BlackBerry 10 capricci
+
+*   **ID**: assegnate dal dispositivo quando si salva il contatto.
+
+### Capricci di FirefoxOS
+
+*   **categorie**: parzialmente supportati. Campi **pref** e **tipo** stanno tornando`null`
+
+*   **IMS**: non supportato
+
+*   **foto**: non supportato
+
+### iOS stranezze
+
+*   **displayName**: non supportata su iOS, tornando `null` se non c'è nessun `ContactName` specificato, nel qual caso restituisce il nome composito, **soprannome** o `""` , rispettivamente.
+
+*   **compleanno**: deve essere inserito come un JavaScript `Date` oggetto, allo stesso modo viene restituito.
+
+*   **foto**: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione. Contenuto della directory temporanea vengono rimossi quando l'applicazione termina.
+
+*   **categorie**: questa proprietà non è attualmente supportata, restituendo`null`.
+
+### Windows Phone 7 e 8 stranezze
+
+*   **displayName**: quando si crea un contatto, il valore specificato per il parametro del nome di visualizzazione è diverso dal nome visualizzato Estratto quando trovare il contatto.
+
+*   **URL**: quando si crea un contatto, gli utenti possono inserire e salvare più di un indirizzo web, ma solo uno è disponibile durante la ricerca del contatto.
+
+*   **phoneNumbers**: non è supportata l'opzione *pref* . Il *tipo* non è supportato in un'operazione di *trovare* . Un solo `phoneNumber` è consentita per ogni *tipo*.
+
+*   **email**: non è supportata l'opzione *pref* . Home e personal fa riferimento la stessa voce di posta elettronica. È consentito un solo ingresso per ogni *tipo*.
+
+*   **indirizzi**: supporta solo lavoro e casa/personali *tipo*. Il riferimento principale e personale *tipo* la stessa voce di indirizzo. È consentito un solo ingresso per ogni *tipo*.
+
+*   **organizzazioni**: solo uno è consentito e non supporta gli attributi *pref*, *tipo*e *dipartimento* .
+
+*   **Nota**: non supportato, restituendo`null`.
+
+*   **IMS**: non supportato, restituendo`null`.
+
+*   **compleanni**: non supportato, restituendo`null`.
+
+*   **categorie**: non supportato, restituendo`null`.
+
+### Stranezze di Windows
+
+*   **foto**: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione.
+
+*   **compleanni**: non supportato, restituendo`null`.
+
+*   **categorie**: non supportato, restituendo`null`.
+
+## ContactAddress
+
+L'oggetto `ContactAddress` memorizza le proprietà di un singolo indirizzo di un contatto. Un oggetto `Contact` può includere più di un indirizzo in una matrice `[] ContactAddress`.
+
+### Proprietà
+
+*   **pref**: impostare su `true` se questo `ContactAddress` contiene il valore dell'utente preferito. *(booleano)*
+
+*   **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+*   **formattato**: indirizzo completo formattato per la visualizzazione. *(DOMString)*
+
+*   **streetAddress**: l'indirizzo completo. *(DOMString)*
+
+*   **località**: la città o località. *(DOMString)*
+
+*   **regione**: lo stato o la regione. *(DOMString)*
+
+*   **postalCode**: il codice postale o il codice postale. *(DOMString)*
+
+*   **paese**: il nome del paese. *(DOMString)*
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+*   Windows
+
+### Esempio
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze di Android 2. x
+
+*   **pref**: non supportato, tornando `false` su dispositivi Android 2. x.
+
+### BlackBerry 10 capricci
+
+*   **pref**: non è supportato sui dispositivi BlackBerry, restituendo`false`.
+
+*   **tipo**: parzialmente supportati. Solo uno di *lavoro* e *casa* tipo indirizzi può essere memorizzato per ciascun contatto.
+
+*   **formattato**: parzialmente supportati. Restituisce una concatenazione di tutti i campi Indirizzo BlackBerry.
+
+*   **streetAddress**: supportato. Restituisce una concatenazione di BlackBerry **Indirizzo1** e **Indirizzo2** campi indirizzo.
+
+*   **località**: supportato. Memorizzato nel campo indirizzo **città** di BlackBerry.
+
+*   **regione**: supportato. Memorizzato nel campo indirizzo di **stateProvince** BlackBerry.
+
+*   **postalCode**: supportato. Memorizzato nel campo dell'indirizzo **zipPostal** BlackBerry.
+
+*   **paese**: supportato.
+
+### Capricci di FirefoxOS
+
+*   **formattato**: attualmente non supportato
+
+### iOS stranezze
+
+*   **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+*   **formattato**: attualmente non supportati.
+
+### Stranezze di Windows 8
+
+*   **pref**: non supportato
+
+### Stranezze di Windows
+
+*   **pref**: non supportato
+
+## ContactError
+
+L'oggetto `ContactError` viene restituito all'utente tramite la funzione di callback `contactError` quando si verifica un errore.
+
+### Proprietà
+
+*   **codice**: uno dei codici di errore predefiniti elencati di seguito.
+
+### Costanti
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+L'oggetto `ContactField` è un componente riutilizzabile che rappresenta Contatta campi genericamente. Ogni oggetto `ContactField` contiene una proprietà di `value`, `type` e `pref`. Un oggetto `Contact` memorizza diverse proprietà in matrici `[] ContactField`, come numeri di telefono e indirizzi email.
+
+Nella maggior parte dei casi, esistono pre-determinati valori per l'attributo `type` di un oggetto **ContactField**. Ad esempio, un numero di telefono può specificare valori di **type** di *casa*, *lavoro*, *mobile*, *iPhone* o qualsiasi altro valore che è supportato dal database dei contatti su una piattaforma particolare dispositivo. Tuttavia, per il campo di **photo** del `Contacto`, il campo **type** indica il formato dell'immagine restituita: **url** quando il **value** di attributo contiene un URL per l'immagine fotografica, o *base64*, quando il **value** contiene una stringa con codifica base64 immagine.
+
+### Proprietà
+
+*   **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+*   **valore**: il valore del campo, ad esempio un telefono numero o indirizzo e-mail. *(DOMString)*
+
+*   **pref**: impostare su `true` se questo `ContactField` contiene il valore dell'utente preferito. *(booleano)*
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+*   Windows
+
+### Esempio
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Stranezze Android
+
+*   **pref**: non supportato, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+*   **tipo**: parzialmente supportati. Usato per i numeri di telefono.
+
+*   **valore**: supportato.
+
+*   **pref**: non supportato, restituendo`false`.
+
+### iOS stranezze
+
+*   **pref**: non supportato, restituendo`false`.
+
+### Stranezze di Windows8
+
+*   **pref**: non supportato, restituendo`false`.
+
+### Stranezze di Windows
+
+*   **pref**: non supportato, restituendo`false`.
+
+## ContactName
+
+Contiene diversi tipi di informazioni sul nome di un oggetto `Contact`.
+
+### Proprietà
+
+*   **formattato**: il nome completo del contatto. *(DOMString)*
+
+*   **familyName**: cognome del contatto. *(DOMString)*
+
+*   **givenName**: nome del contatto. *(DOMString)*
+
+*   **middleName**: il nome del contatto medio. *(DOMString)*
+
+*   **honorificPrefix**: prefisso del contatto (esempio *Mr* o *Dr*) *(DOMString)*
+
+*   **honorificSuffix**: suffisso del contatto (esempio *Esq.*). *(DOMString)*
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+*   Windows
+
+### Esempio
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze Android
+
+*   **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### BlackBerry 10 capricci
+
+*   **formattato**: parzialmente supportati. Restituisce una concatenazione di campi **firstName** e **lastName** BlackBerry.
+
+*   **familyName**: supportato. Archiviato in campo **lastName** BlackBerry.
+
+*   **givenName**: supportato. Archiviato in campo **firstName** BlackBerry.
+
+*   **middleName**: non supportato, restituendo`null`.
+
+*   **honorificPrefix**: non supportato, restituendo`null`.
+
+*   **honorificSuffix**: non supportato, restituendo`null`.
+
+### Capricci di FirefoxOS
+
+*   **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### iOS stranezze
+
+*   **formattato**: parzialmente supportati. Restituisce il nome composito di iOS, ma è di sola lettura.
+
+### Stranezze di Windows 8
+
+*   **formattato**: questo è l'unico nome proprietà ed è identico a `displayName` , e`nickname`
+
+*   **familyName**: non supportato
+
+*   **givenName**: non supportato
+
+*   **middleName**: non supportato
+
+*   **honorificPrefix**: non supportato
+
+*   **honorificSuffix**: non supportato
+
+### Stranezze di Windows
+
+*   **formattato**: esso è identico al`displayName`
+
+## ContactOrganization
+
+L'oggetto `ContactOrganization` memorizza la proprietà di organizzazione di un contatto. Un oggetto `Contact` memorizza uno o più oggetti `ContactOrganization` in una matrice.
+
+### Proprietà
+
+*   **pref**: impostare su `true` se questo `ContactOrganization` contiene il valore dell'utente preferito. *(booleano)*
+
+*   **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. _(DOMString)
+
+*   **nome**: il nome dell'organizzazione. *(DOMString)*
+
+*   **dipartimento**: contratto lavora per il dipartimento. *(DOMString)*
+
+*   **titolo**: titolo del contatto presso l'organizzazione. *(DOMString)*
+
+### Piattaforme supportate
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows (solo dispositivi Windows 8.1 e 8.1 di Windows Phone)
+
+### Esempio
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze di Android 2. x
+
+*   **pref**: non supportato dai dispositivi Android 2. x, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+*   **pref**: non supportato dai dispositivi BlackBerry, restituendo`false`.
+
+*   **tipo**: non supportato dai dispositivi BlackBerry, restituendo`null`.
+
+*   **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **azienda** BlackBerry.
+
+*   **dipartimento**: non supportato, restituendo`null`.
+
+*   **titolo**: parzialmente supportati. Il primo titolo di organizzazione è memorizzato nel campo **jobTitle** BlackBerry.
+
+### Firefox OS stranezze
+
+*   **pref**: non supportato
+
+*   **tipo**: non supportato
+
+*   **dipartimento**: non supportato
+
+*   Campi **nome** e **titolo** memorizzato in **org** e **jobTitle**.
+
+### iOS stranezze
+
+*   **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+*   **tipo**: non è supportato sui dispositivi iOS, restituendo`null`.
+
+*   **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **kABPersonOrganizationProperty** iOS.
+
+*   **dipartimento**: parzialmente supportati. Il primo nome del dipartimento è memorizzato nel campo **kABPersonDepartmentProperty** iOS.
+
+*   **titolo**: parzialmente supportati. Il primo titolo è memorizzato nel campo **kABPersonJobTitleProperty** iOS.
+
+### Stranezze di Windows
+
+*   **pref**: non supportato, restituendo`false`.
+
+*   **tipo**: non supportato, restituendo`null`.

km0App/node_modules/cordova-plugin-contacts/doc/ja/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+このプラグインは、デバイスの連絡先データベースへのアクセスを提供するグローバル `navigator.contacts` オブジェクトを定義します。
+
+オブジェクトは、グローバル スコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くお勧めデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、**[ok]** を **おかげで** 選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
+
+## インストール
+
+これはコルドバ 5.0 + (現在安定 v1.0.0) を必要とします。
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+コルドバの古いバージョンでも**非推奨**id (古い v0.2.16) 経由でインストールできます。
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+また、レポの url 経由で直接インストールすることが可能だ (不安定)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### Firefox OS 癖
+
+[マニフェストのドキュメント](https://developer.mozilla.org/en-US/Apps/Developing/Manifest) で説明されているように、**www/manifest.webapp** を作成します。 関連する権限を追加します。 [マニフェストのドキュメント](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type)「特権」- に web アプリケーションの種類を変更する必要も。 **警告**: すべての特権を持つアプリケーション インライン スクリプトを禁止している [コンテンツのセキュリティ ポリシー](https://developer.mozilla.org/en-US/Apps/CSP) を適用します。 別の方法で、アプリケーションを初期化します。
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows の癖
+
+**Windows 10 前に:**すべての連絡先を`検索`し、 `pickContact`メソッドから返されるアプリケーションが変更できないように読み取り専用であります。 `find` メソッド 8.1 の Windows Phone デバイスでのみ使用できます。
+
+**Windows 10 以上:**連絡先は、保存可能性があります、連絡先アプリ ローカル記憶域に保存されます。 連絡先も削除されます。
+
+### Windows 8 の癖
+
+Windows 8 の連絡先は、読み取り専用です。 コルドバ API コンタクトを介してされませんクエリ/検索可能で、ユーザーに通知する必要があります連絡先を選択 '人' アプリを開くことが contacts.pickContact への呼び出しとして、ユーザーが連絡先を選択する必要があります。 戻される連絡先は読み取り専用、アプリケーションを変更することはできません。
+
+## navigator.contacts
+
+### メソッド
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### オブジェクト
+
+  * お問い合わせ
+  * ContactName
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create` メソッドは同期的に、新しい `連絡先` オブジェクトを返します。
+
+このメソッドは、`Contact.save` メソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しません。
+
+### サポートされているプラットフォーム
+
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+
+### 例
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+デバイスの連絡先データベースを照会して、`Contact` オブジェクトの配列を返す `navigator.contacts.find` メソッドを非同期的に実行します。 結果として得られるオブジェクトは、**contactSuccess** パラメーターで指定された `contactSuccess` コールバック関数に渡されます。
+
+**contactFields** パラメーター検索の修飾子として使用するフィールドを指定します。 ゼロ長さ **contactFields** パラメーターは有効で、`ContactError.INVALID_ARGUMENT_ERROR` の結果します。 **contactFields** 値 `"*"` すべての連絡先フィールドが検索されます。
+
+**contactFindOptions.filter** 文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する **contactFields** パラメーターで指定されたフィールドごとに適用されます。 一致する *任意* 指定のフィールドがある場合は、連絡先が返されます。 バック連絡先プロパティを制御する **contactFindOptions.desiredFields** パラメーターを使用しますが返される必要があります。
+
+### パラメーター
+
+  * **contactFields**: 連絡先検索修飾子として使用するフィールド。*(DOMString[])* [Required]
+
+  * **contactSuccess**: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[Required]
+
+  * **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+  * **contactFindOptions**: navigator.contacts をフィルターするオプションを検索します。[Optional]
+    
+    キーは次のとおりです。
+    
+      * **filter**: navigator.contacts の検索に使用する検索文字列。*（，）*(デフォルト: `""`)
+    
+      * **multiple**: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。*(ブール値)*(デフォルト: `false`)
+        
+          * **desiredFields**： 戻って返されるフィールドに問い合わせてください。指定した場合、結果 `Contact` オブジェクトこれらのフィールドの値でのみ機能します。*(DOMString[])* [Optional]
+
+### サポートされているプラットフォーム
+
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+  * Windows (Windows Phone 8.1 および Windows 10)
+
+### 例
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows の癖
+
+  * `__contactFields__`サポートされていないと無視されます。`find`メソッドは、常に名前、電子メール アドレス、または連絡先の電話番号に一致ましょう。
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact` メソッドは単一の連絡先を選択する連絡先ピッカーを起動します。 結果として得られるオブジェクトは、**contactSuccess** パラメーターで指定された `contactSuccess` コールバック関数に渡されます。
+
+### パラメーター
+
+  * **contactSuccess**: 1 つの連絡先オブジェクトに呼び出される成功コールバック関数。[必須]
+
+  * **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+### サポートされているプラットフォーム
+
+  * アンドロイド
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### 例
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## お問い合わせ
+
+`Contact` オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 連絡先も取得できます (個別にまたは一括で) データベースから `navigator.contacts.find` メソッドを呼び出すことによって。
+
+**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの *互換* セクションを確認してください。
+
+### プロパティ
+
+  * **id**： グローバルに一意の識別子。*（，）*
+
+  * **displayName**: エンド ・ ユーザーへの表示に適した、この連絡先の名前。*（，）*
+
+  * **名前**： 人の名前のすべてのコンポーネントを格納するオブジェクト。*(ContactName)*
+
+  * **ニックネーム**: 連絡先のアドレスに使用するカジュアルな名前。*（，）*
+
+  * **電話番号**: 連絡先の電話番号の配列。*(ContactField[])*
+
+  * **メール**： 連絡先の電子メール アドレスの配列。*(ContactField[])*
+
+  * **アドレス**: 連絡先のアドレスの配列。*(ContactAddress[])*
+
+  * **ims**： 連絡先の IM アドレスの配列。*(ContactField[])*
+
+  * **組織**: 連絡先の組織の配列。*(ContactOrganization[])*
+
+  * **誕生日**: 連絡先の誕生日。*（日）*
+
+  * **注**: 連絡先についてのメモ。*（，）*
+
+  * **写真**: 連絡先の写真の配列。*(ContactField[])*
+
+  * **カテゴリ**: 取引先担当者に関連付けられているすべてのユーザー定義カテゴリの配列。*(ContactField[])*
+
+  * **url**: 取引先担当者に関連付けられている web ページの配列。*(ContactField[])*
+
+### メソッド
+
+  * **クローン**： 新しいを返します `Contact` と呼び出し元のオブジェクトのディープ コピーであるオブジェクトの `id` プロパティに設定`null`.
+
+  * **削除**: デバイスの連絡先データベースから連絡先を削除します、それ以外の場合のためのエラー コールバックを実行する、 `ContactError` オブジェクト。
+
+  * **保存**: デバイスの連絡先データベースに新しい連絡先を保存または同じ**id**を持つ連絡先が既に存在する場合、既存の連絡先を更新します。
+
+### サポートされているプラットフォーム
+
+  * アマゾン火 OS
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+  * Windows 8
+  * Windows
+
+### 保存の例
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### クローンの例
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### 削除の例
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### アンドロイド 2.X 癖
+
+  * **カテゴリ**: 返す 2.X の Android デバイスでサポートされていません`null`.
+
+### ブラックベリー 10 癖
+
+  * **id**: 連絡先を保存するときに、デバイスによって割り当てられます。
+
+### FirefoxOS の癖
+
+  * **カテゴリ**: 部分的にサポートされます。フィールド**県**・**タイプ**を返す`null`
+
+  * **ims**: サポートされていません。
+
+  * **写真**: サポートされていません。
+
+### iOS の癖
+
+  * **displayName**: 返す iOS でサポートされていない `null` がない限り、ない `ContactName` 指定すると、その場合は複合名、**ニックネーム**を返しますまたは `""` 、それぞれ。
+
+  * **誕生日**: JavaScript として入力する必要があります `Date` オブジェクト、同じ方法が返されます。
+
+  * **写真**： アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。一時ディレクトリの内容は、アプリケーションの終了時に削除されます。
+
+  * **カテゴリ**: このプロパティは現在サポートされていません、返す`null`.
+
+### Windows Phone 7 と 8 癖
+
+  * **displayName**: 表示名パラメーターの表示名と異なるために提供値を取得、連絡先を検索するとき、連絡先を作成するとき。
+
+  * **url**: 連絡先を作成するときユーザー入力保存でき、1 つ以上の web アドレスが 1 つだけ、連絡先を検索するとき。
+
+  * **電話番号**:*県*オプションはサポートされていません。 *型*は、*検索*操作ではサポートされていません。 1 つだけ `phoneNumber` は各*タイプ*の許可.
+
+  * **メール**：*県*オプションはサポートされていません。家庭や個人的なメールと同じエントリを参照します。各*タイプ*の 1 つだけのエントリが許可されて.
+
+  * **アドレス**: 仕事とホーム/パーソナル*タイプ*のみをサポートしています。家庭や個人*型*参照して同じアドレス エントリ。各*タイプ*の 1 つだけのエントリが許可されて.
+
+  * **組織**： 1 つだけが許可され、*県*、*タイプ*、および*部門*の属性をサポートしていません。
+
+  * **注**: サポートされていないを返す`null`.
+
+  * **ims**: サポートされていないを返す`null`.
+
+  * **誕生日**: サポートされていないを返す`null`.
+
+  * **カテゴリ**: サポートされていないを返す`null`.
+
+  * **remove**: メソッドはサポートされていません
+
+### Windows の癖
+
+  * **写真**： アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。
+
+  * **誕生日**: サポートされていないを返す`null`.
+
+  * **カテゴリ**: サポートされていないを返す`null`.
+
+  * **remove**: Windows 10 以上メソッドはサポートされてのみ。
+
+## ContactAddress
+
+`ContactAddress` オブジェクトは、連絡先の 1 つのアドレスのプロパティを格納します。 `Contact` オブジェクトは、`ContactAddress` 配列の 1 つ以上のアドレスなどがあります。
+
+### プロパティ
+
+  * **県**: に設定されている `true` 場合は、この `ContactAddress` ユーザーの推奨値が含まれています。*(ブール値)*
+
+  * **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+  * **書式設定**: 表示用にフォーマットの完全なアドレス。*（，）*
+
+  * **番地**： 完全な住所。*（，）*
+
+  * **局所性**: 都市または場所。*（，）*
+
+  * **地域**: 状態または地域。*（，）*
+
+  * **郵便番号**： 郵便番号または郵便番号。*（，）*
+
+  * **国**: 国の名前。*（，）*
+
+### サポートされているプラットフォーム
+
+  * アマゾン火 OS
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+  * Windows 8
+  * Windows
+
+### 例
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### アンドロイド 2.X 癖
+
+  * **県**: サポートされていない返す `false` 2.X の Android デバイスで。
+
+### ブラックベリー 10 癖
+
+  * **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+  * **種類**: 部分的にサポートされます。連絡先ごとの 1 つだけ各*仕事*と*家庭*の種類のアドレスを格納できます。
+
+  * **フォーマット**： 部分的にサポートされます。すべての BlackBerry アドレス フィールドの連結を返します。
+
+  * **番地**： サポートされています。ブラックベリーの**住所 1** **住所 2**の連結アドレス フィールドを返します。
+
+  * **局所性**： サポートされています。ブラックベリー**市**アドレス フィールドに格納されます。
+
+  * **地域**: サポートされています。ブラックベリー **stateProvince**アドレス フィールドに格納されます。
+
+  * **郵便番号**： サポートされています。ブラックベリー **zipPostal**アドレス フィールドに格納されます。
+
+  * **国**: サポートされています。
+
+### FirefoxOS の癖
+
+  * **フォーマット**: 現在サポートされていません
+
+### iOS の癖
+
+  * **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+  * **フォーマット**: 現在サポートされていません。
+
+### Windows 8 の癖
+
+  * **県**: サポートされていません。
+
+### Windows の癖
+
+  * **県**: サポートされていません。
+
+## ContactError
+
+`ContactError` オブジェクトにエラーが発生したときに `contactError` コールバック関数を通じてユーザーに返されます。
+
+### プロパティ
+
+  * **コード**: 次のいずれかの定義済みのエラー コード。
+
+### 定数
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField` オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトには `値` `型`、および `県` プロパティが含まれています。 `連絡先` オブジェクトは、`ContactField` 配列に、電話番号、メール アドレスなどのいくつかのプロパティを格納します。
+
+ほとんどの場合、`ContactField` オブジェクトの **type** 属性のあらかじめ決められた値はありません。 たとえば、電話番号が *ホーム*、*仕事*、*モバイル*、*iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の **型** の値を指定できます。 ただし、`連絡先` **の写真**] のフィールド **の種類**] フィールドを示します返される画像の形式: **url** **値** 属性 **値** を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは *base64* に URL が含まれる場合。
+
+### プロパティ
+
+  * **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+  * **値**: 電話番号や電子メール アドレスなど、フィールドの値。*（，）*
+
+  * **県**: に設定されている `true` 場合は、この `ContactField` ユーザーの推奨値が含まれています。*(ブール値)*
+
+### サポートされているプラットフォーム
+
+  * アマゾン火 OS
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+  * Windows 8
+  * Windows
+
+### 例
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Android の癖
+
+  * **県**: サポートされていないを返す`false`.
+
+### ブラックベリー 10 癖
+
+  * **種類**: 部分的にサポートされます。電話番号を使用します。
+
+  * **値**: サポートされています。
+
+  * **県**: サポートされていないを返す`false`.
+
+### iOS の癖
+
+  * **県**: サポートされていないを返す`false`.
+
+### Windows8 の癖
+
+  * **県**: サポートされていないを返す`false`.
+
+### Windows の癖
+
+  * **県**: サポートされていないを返す`false`.
+
+## ContactName
+
+異なる種類 `Contact` オブジェクトの名前についての情報にはが含まれています。
+
+### プロパティ
+
+  * **フォーマット**: 連絡先の完全な名前。*（，）*
+
+  * **familyName**: 連絡先の姓。*（，）*
+
+  * **givenName**: 連絡先の名前。*（，）*
+
+  * **ミドル ネーム**: 連絡先のミドル ネーム。*（，）*
+
+  * **honorificPrefix**: 連絡先のプレフィックス (例*氏*または*博士*) *(，)*
+
+  * **honorificSuffix**: 連絡先のサフィックス (*弁護士*の例)。*（，）*
+
+### サポートされているプラットフォーム
+
+  * アマゾン火 OS
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+  * Windows 8
+  * Windows
+
+### 例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android の癖
+
+  * **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### ブラックベリー 10 癖
+
+  * **フォーマット**： 部分的にサポートされます。ブラックベリー **firstName**と**lastName**フィールドの連結を返します。
+
+  * **familyName**: サポートされています。ブラックベリー **[氏名]**フィールドに格納されます。
+
+  * **givenName**: サポートされています。ブラックベリーの**firstName**フィールドに格納されます。
+
+  * **ミドル ネーム**: サポートされていないを返す`null`.
+
+  * **honorificPrefix**: サポートされていないを返す`null`.
+
+  * **honorificSuffix**: サポートされていないを返す`null`.
+
+### FirefoxOS の癖
+
+  * **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### iOS の癖
+
+  * **フォーマット**： 部分的にサポートされます。IOS 複合名を返しますが、読み取り専用です。
+
+### Windows 8 の癖
+
+  * **フォーマット**： これは、プロパティの名前し、同じです `displayName` と`nickname`
+
+  * **familyName**: サポートされていません。
+
+  * **givenName**: サポートされていません。
+
+  * **ミドル ネーム**: サポートされていません。
+
+  * **honorificPrefix**: サポートされていません。
+
+  * **honorificSuffix**: サポートされていません。
+
+### Windows の癖
+
+  * **フォーマット**： と同じです`displayName`
+
+## ContactOrganization
+
+`ContactOrganization` オブジェクトは、連絡先の組織のプロパティを格納します。`連絡先` オブジェクトは、配列の 1 つ以上の `ContactOrganization` オブジェクトを格納します。
+
+### プロパティ
+
+  * **県**: に設定されている `true` 場合は、この `ContactOrganization` ユーザーの推奨値が含まれています。*(ブール値)*
+
+  * **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。_(DOMString)
+
+  * **名前**: 組織の名前。*（，）*
+
+  * **部門**: 契約に勤めている部門。*（，）*
+
+  * **タイトル**: 組織の連絡先のタイトル。*（，）*
+
+### サポートされているプラットフォーム
+
+  * アンドロイド
+  * ブラックベリー 10
+  * Firefox の OS
+  * iOS
+  * Windows Phone 7 と 8
+  * Windows (Windows 8.1 および Windows Phone 8.1 装置のみ）
+
+### 例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### アンドロイド 2.X 癖
+
+  * **県**: 返す 2.X の Android デバイスでサポートされていません`false`.
+
+### ブラックベリー 10 癖
+
+  * **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+  * **タイプ**： 戻る、BlackBerry デバイスでサポートされていません`null`.
+
+  * **名前**： 部分的にサポートされます。最初の組織名は、**会社**のブラックベリーのフィールドに格納されます。
+
+  * **部門**: サポートされていないを返す`null`.
+
+  * **タイトル**: 部分的にサポートされます。組織の最初のタイトルはブラックベリー**氏名**フィールドに格納されます。
+
+### Firefox OS 癖
+
+  * **県**: サポートされていません。
+
+  * **タイプ**: サポートされていません。
+
+  * **部門**: サポートされていません。
+
+  * フィールドの**名前**と**組織**、**氏名**に格納された**タイトル**.
+
+### iOS の癖
+
+  * **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+  * **タイプ**： 戻る iOS デバイスでサポートされていません`null`.
+
+  * **名前**： 部分的にサポートされます。最初の組織名は、iOS **kABPersonOrganizationProperty**フィールドに格納されます。
+
+  * **部門**: 部分的にサポートされます。最初の部署名は iOS **kABPersonDepartmentProperty**フィールドに格納されます。
+
+  * **タイトル**: 部分的にサポートされます。最初のタイトルは、iOS **kABPersonJobTitleProperty**フィールドに格納されます。
+
+### Windows の癖
+
+  * **県**: サポートされていないを返す`false`.
+
+  * **タイプ**: サポートされていないを返す`null`.

km0App/node_modules/cordova-plugin-contacts/doc/ja/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+このプラグインは、デバイスの連絡先データベースへのアクセスを提供するグローバル `navigator.contacts` オブジェクトを定義します。
+
+オブジェクトは、グローバル スコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くお勧めデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、**[ok]** を **おかげで** 選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
+
+## インストール
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### Firefox OS 癖
+
+[マニフェストのドキュメント][1] で説明されているように、**www/manifest.webapp** を作成します。 関連する権限を追加します。 [マニフェストのドキュメント][2]「特権」- に web アプリケーションの種類を変更する必要も。 **警告**: すべての特権を持つアプリケーション インライン スクリプトを禁止している [コンテンツのセキュリティ ポリシー][3] を適用します。 別の方法で、アプリケーションを初期化します。
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows の癖
+
+`find` し、`pickContact` メソッドから返されるすべての連絡先は readonly、アプリケーションを変更することはできません。 `find` メソッド 8.1 の Windows Phone デバイスでのみ使用できます。
+
+### Windows 8 の癖
+
+Windows 8 の連絡先は、読み取り専用です。 コルドバ API コンタクトを介してされませんクエリ/検索可能で、ユーザーに通知する必要があります連絡先を選択 '人' アプリを開くことが contacts.pickContact への呼び出しとして、ユーザーが連絡先を選択する必要があります。 戻される連絡先は読み取り専用、アプリケーションを変更することはできません。
+
+## navigator.contacts
+
+### メソッド
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### オブジェクト
+
+*   お問い合わせ
+*   得意先コード
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create` メソッドは同期的に、新しい `連絡先` オブジェクトを返します。
+
+このメソッドは、`Contact.save` メソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しません。
+
+### サポートされているプラットフォーム
+
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+
+### 例
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+デバイスの連絡先データベースを照会して、`Contact` オブジェクトの配列を返す `navigator.contacts.find` メソッドを非同期的に実行します。 結果として得られるオブジェクトは、**contactSuccess** パラメーターで指定された `contactSuccess` コールバック関数に渡されます。
+
+**contactFields** パラメーター検索の修飾子として使用するフィールドを指定します。 ゼロ長さ **contactFields** パラメーターは有効で、`ContactError.INVALID_ARGUMENT_ERROR` の結果します。 **contactFields** 値 `"*"` すべての連絡先フィールドが検索されます。
+
+**contactFindOptions.filter** 文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する **contactFields** パラメーターで指定されたフィールドごとに適用されます。 一致する *任意* 指定のフィールドがある場合は、連絡先が返されます。 バック連絡先プロパティを制御する **contactFindOptions.desiredFields** パラメーターを使用しますが返される必要があります。
+
+### パラメーター
+
+*   **contactFields**: 連絡先検索修飾子として使用するフィールド。*(DOMString[])* [Required]
+
+*   **contactSuccess**: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[Required]
+
+*   **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+*   **contactFindOptions**: navigator.contacts をフィルターするオプションを検索します。[Optional]
+    
+    キーは次のとおりです。
+    
+    *   **filter**: navigator.contacts の検索に使用する検索文字列。*（，）*(デフォルト: `""`)
+    
+    *   **multiple**: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。*(ブール値)*(デフォルト: `false`)
+        
+        *   **desiredFields**： 戻って返されるフィールドに問い合わせてください。指定した場合、結果 `Contact` オブジェクトこれらのフィールドの値でのみ機能します。*(DOMString[])* [Optional]
+
+### サポートされているプラットフォーム
+
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+*   Windows (Windows Phone 8.1 装置のみ）
+
+### 例
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows の癖
+
+*   `__contactFields__`サポートされていないと無視されます。`find`メソッドは、常に名前、電子メール アドレス、または連絡先の電話番号に一致ましょう。
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact` メソッドは単一の連絡先を選択する連絡先ピッカーを起動します。 結果として得られるオブジェクトは、**contactSuccess** パラメーターで指定された `contactSuccess` コールバック関数に渡されます。
+
+### パラメーター
+
+*   **contactSuccess**: 1 つの連絡先オブジェクトに呼び出される成功コールバック関数。[必須]
+
+*   **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+### サポートされているプラットフォーム
+
+*   アンドロイド
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### 例
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## お問い合わせ
+
+`Contact` オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 連絡先も取得できます (個別にまたは一括で) データベースから `navigator.contacts.find` メソッドを呼び出すことによって。
+
+**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの *互換* セクションを確認してください。
+
+### プロパティ
+
+*   **id**： グローバルに一意の識別子。*（，）*
+
+*   **displayName**: エンド ・ ユーザーへの表示に適した、この連絡先の名前。*（，）*
+
+*   **名前**： 人の名前のすべてのコンポーネントを格納するオブジェクト。*(ContactName)*
+
+*   **ニックネーム**: 連絡先のアドレスに使用するカジュアルな名前。*（，）*
+
+*   **電話番号**: 連絡先の電話番号の配列。*(ContactField[])*
+
+*   **メール**： 連絡先の電子メール アドレスの配列。*(ContactField[])*
+
+*   **アドレス**: 連絡先のアドレスの配列。*(ContactAddress[])*
+
+*   **ims**： 連絡先の IM アドレスの配列。*(ContactField[])*
+
+*   **組織**: 連絡先の組織の配列。*(ContactOrganization[])*
+
+*   **誕生日**: 連絡先の誕生日。*（日）*
+
+*   **注**: 連絡先についてのメモ。*（，）*
+
+*   **写真**: 連絡先の写真の配列。*(ContactField[])*
+
+*   **カテゴリ**: 取引先担当者に関連付けられているすべてのユーザー定義カテゴリの配列。*(ContactField[])*
+
+*   **url**: 取引先担当者に関連付けられている web ページの配列。*(ContactField[])*
+
+### メソッド
+
+*   **クローン**： 新しいを返します `Contact` と呼び出し元のオブジェクトのディープ コピーであるオブジェクトの `id` プロパティに設定`null`.
+
+*   **削除**: デバイスの連絡先データベースから連絡先を削除します、それ以外の場合のためのエラー コールバックを実行する、 `ContactError` オブジェクト。
+
+*   **保存**: デバイスの連絡先データベースに新しい連絡先を保存または同じ**id**を持つ連絡先が既に存在する場合、既存の連絡先を更新します。
+
+### サポートされているプラットフォーム
+
+*   アマゾン火 OS
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+*   Windows 8
+*   Windows
+
+### 保存の例
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### クローンの例
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### 削除の例
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### アンドロイド 2.X 癖
+
+*   **カテゴリ**: 返す 2.X の Android デバイスでサポートされていません`null`.
+
+### ブラックベリー 10 癖
+
+*   **id**: 連絡先を保存するときに、デバイスによって割り当てられます。
+
+### FirefoxOS の癖
+
+*   **カテゴリ**: 部分的にサポートされます。フィールド**県**・**タイプ**を返す`null`
+
+*   **ims**: サポートされていません。
+
+*   **写真**: サポートされていません。
+
+### iOS の癖
+
+*   **displayName**: 返す iOS でサポートされていない `null` がない限り、ない `ContactName` 指定すると、その場合は複合名、**ニックネーム**を返しますまたは `""` 、それぞれ。
+
+*   **誕生日**: JavaScript として入力する必要があります `Date` オブジェクト、同じ方法が返されます。
+
+*   **写真**： アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。一時ディレクトリの内容は、アプリケーションの終了時に削除されます。
+
+*   **カテゴリ**: このプロパティは現在サポートされていません、返す`null`.
+
+### Windows Phone 7 と 8 癖
+
+*   **displayName**: 表示名パラメーターの表示名と異なるために提供値を取得、連絡先を検索するとき、連絡先を作成するとき。
+
+*   **url**: 連絡先を作成するときユーザー入力保存でき、1 つ以上の web アドレスが 1 つだけ、連絡先を検索するとき。
+
+*   **電話番号**:*県*オプションはサポートされていません。 *型*は、*検索*操作ではサポートされていません。 1 つだけ `phoneNumber` は各*タイプ*の許可.
+
+*   **メール**：*県*オプションはサポートされていません。家庭や個人的なメールと同じエントリを参照します。各*タイプ*の 1 つだけのエントリが許可されて.
+
+*   **アドレス**: 仕事とホーム/パーソナル*タイプ*のみをサポートしています。家庭や個人*型*参照して同じアドレス エントリ。各*タイプ*の 1 つだけのエントリが許可されて.
+
+*   **組織**： 1 つだけが許可され、*県*、*タイプ*、および*部門*の属性をサポートしていません。
+
+*   **注**: サポートされていないを返す`null`.
+
+*   **ims**: サポートされていないを返す`null`.
+
+*   **誕生日**: サポートされていないを返す`null`.
+
+*   **カテゴリ**: サポートされていないを返す`null`.
+
+### Windows の癖
+
+*   **写真**： アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。
+
+*   **誕生日**: サポートされていないを返す`null`.
+
+*   **カテゴリ**: サポートされていないを返す`null`.
+
+## ContactAddress
+
+`ContactAddress` オブジェクトは、連絡先の 1 つのアドレスのプロパティを格納します。 `Contact` オブジェクトは、`ContactAddress` 配列の 1 つ以上のアドレスなどがあります。
+
+### プロパティ
+
+*   **県**: に設定されている `true` 場合は、この `ContactAddress` ユーザーの推奨値が含まれています。*(ブール値)*
+
+*   **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+*   **書式設定**: 表示用にフォーマットの完全なアドレス。*（，）*
+
+*   **番地**： 完全な住所。*（，）*
+
+*   **局所性**: 都市または場所。*（，）*
+
+*   **地域**: 状態または地域。*（，）*
+
+*   **郵便番号**： 郵便番号または郵便番号。*（，）*
+
+*   **国**: 国の名前。*（，）*
+
+### サポートされているプラットフォーム
+
+*   アマゾン火 OS
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+*   Windows 8
+*   Windows
+
+### 例
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### アンドロイド 2.X 癖
+
+*   **県**: サポートされていない返す `false` 2.X の Android デバイスで。
+
+### ブラックベリー 10 癖
+
+*   **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+*   **種類**: 部分的にサポートされます。連絡先ごとの 1 つだけ各*仕事*と*家庭*の種類のアドレスを格納できます。
+
+*   **フォーマット**： 部分的にサポートされます。すべての BlackBerry アドレス フィールドの連結を返します。
+
+*   **番地**： サポートされています。ブラックベリーの**住所 1** **住所 2**の連結アドレス フィールドを返します。
+
+*   **局所性**： サポートされています。ブラックベリー**市**アドレス フィールドに格納されます。
+
+*   **地域**: サポートされています。ブラックベリー **stateProvince**アドレス フィールドに格納されます。
+
+*   **郵便番号**： サポートされています。ブラックベリー **zipPostal**アドレス フィールドに格納されます。
+
+*   **国**: サポートされています。
+
+### FirefoxOS の癖
+
+*   **フォーマット**: 現在サポートされていません
+
+### iOS の癖
+
+*   **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+*   **フォーマット**: 現在サポートされていません。
+
+### Windows 8 の癖
+
+*   **県**: サポートされていません。
+
+### Windows の癖
+
+*   **県**: サポートされていません。
+
+## ContactError
+
+`ContactError` オブジェクトにエラーが発生したときに `contactError` コールバック関数を通じてユーザーに返されます。
+
+### プロパティ
+
+*   **コード**: 次のいずれかの定義済みのエラー コード。
+
+### 定数
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField` オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトには `値` `型`、および `県` プロパティが含まれています。 `連絡先` オブジェクトは、`ContactField` 配列に、電話番号、メール アドレスなどのいくつかのプロパティを格納します。
+
+ほとんどの場合、`ContactField` オブジェクトの **type** 属性のあらかじめ決められた値はありません。 たとえば、電話番号が *ホーム*、*仕事*、*モバイル*、*iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の **型** の値を指定できます。 ただし、`連絡先` **の写真**] のフィールド **の種類**] フィールドを示します返される画像の形式: **url** **値** 属性 **値** を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは *base64* に URL が含まれる場合。
+
+### プロパティ
+
+*   **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+*   **値**: 電話番号や電子メール アドレスなど、フィールドの値。*（，）*
+
+*   **県**: に設定されている `true` 場合は、この `ContactField` ユーザーの推奨値が含まれています。*(ブール値)*
+
+### サポートされているプラットフォーム
+
+*   アマゾン火 OS
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+*   Windows 8
+*   Windows
+
+### 例
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Android の癖
+
+*   **県**: サポートされていないを返す`false`.
+
+### ブラックベリー 10 癖
+
+*   **種類**: 部分的にサポートされます。電話番号を使用します。
+
+*   **値**: サポートされています。
+
+*   **県**: サポートされていないを返す`false`.
+
+### iOS の癖
+
+*   **県**: サポートされていないを返す`false`.
+
+### Windows8 の癖
+
+*   **県**: サポートされていないを返す`false`.
+
+### Windows の癖
+
+*   **県**: サポートされていないを返す`false`.
+
+## 得意先コード
+
+異なる種類 `Contact` オブジェクトの名前についての情報にはが含まれています。
+
+### プロパティ
+
+*   **フォーマット**: 連絡先の完全な名前。*（，）*
+
+*   **familyName**: 連絡先の姓。*（，）*
+
+*   **givenName**: 連絡先の名前。*（，）*
+
+*   **ミドル ネーム**: 連絡先のミドル ネーム。*（，）*
+
+*   **honorificPrefix**: 連絡先のプレフィックス (例*氏*または*博士*) *(，)*
+
+*   **honorificSuffix**: 連絡先のサフィックス (*弁護士*の例)。*（，）*
+
+### サポートされているプラットフォーム
+
+*   アマゾン火 OS
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+*   Windows 8
+*   Windows
+
+### 例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android の癖
+
+*   **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### ブラックベリー 10 癖
+
+*   **フォーマット**： 部分的にサポートされます。ブラックベリー **firstName**と**lastName**フィールドの連結を返します。
+
+*   **familyName**: サポートされています。ブラックベリー **[氏名]**フィールドに格納されます。
+
+*   **givenName**: サポートされています。ブラックベリーの**firstName**フィールドに格納されます。
+
+*   **ミドル ネーム**: サポートされていないを返す`null`.
+
+*   **honorificPrefix**: サポートされていないを返す`null`.
+
+*   **honorificSuffix**: サポートされていないを返す`null`.
+
+### FirefoxOS の癖
+
+*   **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### iOS の癖
+
+*   **フォーマット**： 部分的にサポートされます。IOS 複合名を返しますが、読み取り専用です。
+
+### Windows 8 の癖
+
+*   **フォーマット**： これは、プロパティの名前し、同じです `displayName` と`nickname`
+
+*   **familyName**: サポートされていません。
+
+*   **givenName**: サポートされていません。
+
+*   **ミドル ネーム**: サポートされていません。
+
+*   **honorificPrefix**: サポートされていません。
+
+*   **honorificSuffix**: サポートされていません。
+
+### Windows の癖
+
+*   **フォーマット**： と同じです`displayName`
+
+## ContactOrganization
+
+`ContactOrganization` オブジェクトは、連絡先の組織のプロパティを格納します。`連絡先` オブジェクトは、配列の 1 つ以上の `ContactOrganization` オブジェクトを格納します。
+
+### プロパティ
+
+*   **県**: に設定されている `true` 場合は、この `ContactOrganization` ユーザーの推奨値が含まれています。*(ブール値)*
+
+*   **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。_(DOMString)
+
+*   **名前**: 組織の名前。*（，）*
+
+*   **部門**: 契約に勤めている部門。*（，）*
+
+*   **タイトル**: 組織の連絡先のタイトル。*（，）*
+
+### サポートされているプラットフォーム
+
+*   アンドロイド
+*   ブラックベリー 10
+*   Firefox の OS
+*   iOS
+*   Windows Phone 7 と 8
+*   Windows (Windows 8.1 および Windows Phone 8.1 装置のみ）
+
+### 例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### アンドロイド 2.X 癖
+
+*   **県**: 返す 2.X の Android デバイスでサポートされていません`false`.
+
+### ブラックベリー 10 癖
+
+*   **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+*   **タイプ**： 戻る、BlackBerry デバイスでサポートされていません`null`.
+
+*   **名前**： 部分的にサポートされます。最初の組織名は、**会社**のブラックベリーのフィールドに格納されます。
+
+*   **部門**: サポートされていないを返す`null`.
+
+*   **タイトル**: 部分的にサポートされます。組織の最初のタイトルはブラックベリー**氏名**フィールドに格納されます。
+
+### Firefox OS 癖
+
+*   **県**: サポートされていません。
+
+*   **タイプ**: サポートされていません。
+
+*   **部門**: サポートされていません。
+
+*   フィールドの**名前**と**組織**、**氏名**に格納された**タイトル**.
+
+### iOS の癖
+
+*   **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+*   **タイプ**： 戻る iOS デバイスでサポートされていません`null`.
+
+*   **名前**： 部分的にサポートされます。最初の組織名は、iOS **kABPersonOrganizationProperty**フィールドに格納されます。
+
+*   **部門**: 部分的にサポートされます。最初の部署名は iOS **kABPersonDepartmentProperty**フィールドに格納されます。
+
+*   **タイトル**: 部分的にサポートされます。最初のタイトルは、iOS **kABPersonJobTitleProperty**フィールドに格納されます。
+
+### Windows の癖
+
+*   **県**: サポートされていないを返す`false`.
+
+*   **タイプ**: サポートされていないを返す`null`.

km0App/node_modules/cordova-plugin-contacts/doc/ko/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+이 플러그인 장치 연락처 데이터베이스에 대 한 액세스를 제공 하는 글로벌 `navigator.contacts` 개체를 정의 합니다.
+
+개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**경고**: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서, 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강력 하 게 고려해 야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, **확인** 및 **아니오** 선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세스 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
+
+## 설치
+
+코르도바 5.0 + (현재 안정적인 v1.0.0) 필요
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+코르도바의 이전 버전 **사용** id (오래 된 v0.2.16)를 통해 설치할 수 있습니다.
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+그것은 또한 배상 계약 url을 통해 직접 설치할 수 (불안정)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### 파이어 폭스 OS 단점
+
+[참고 문서](https://developer.mozilla.org/en-US/Apps/Developing/Manifest)에 설명 된 대로 **www/manifest.webapp**를 만듭니다. 관련 부여할 추가 합니다. [참고 문서](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type)에 "privileged"-webapp 유형을 변경 하려면 필요가 하다. **경고**: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책](https://developer.mozilla.org/en-US/Apps/CSP)을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### 윈도우 특수
+
+**이전에 창 10:** `찾기` 및 `pickContact` 메서드에서 반환 하는 모든 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다. `찾을` 방법은 Windows Phone 8.1 장치에만 사용할 수 있습니다.
+
+**윈도우 10 이상:** 연락처 저장 되 고 응용 프로그램 로컬 연락처 저장소에 저장 됩니다. 연락처도 삭제 될 수 있습니다.
+
+### 윈도우 8 단점
+
+윈도우 8 연락처는 읽기 전용입니다. 코르 도우 바 API 연락처를 통해 하지 쿼리/검색할 수 있습니다, 사용자 알려 '사람' 애플 리 케이 션을 열 것 이다 contacts.pickContact에 대 한 호출으로 연락처를 선택 하 여 사용자 연락처를 선택 해야 합니다. 반환 된 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다.
+
+## navigator.contacts
+
+### 메서드
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### 개체
+
+  * 연락처
+  * 담당자 이름
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create` 메서드는 동기적 및 새 `연락처` 개체를 반환 합니다.
+
+이 메서드는 `Contact.save` 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다.
+
+### 지원 되는 플랫폼
+
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+
+### 예를 들어
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+장치 연락처 데이터베이스 쿼리 및 `Contact` 개체의 배열을 반환 `navigator.contacts.find` 메서드를 비동기적으로 실행 합니다. 결과 개체는 **contactSuccess** 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.
+
+**contactFields** 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 **contactFields** 매개 변수가 유효 하 고 `ContactError.INVALID_ARGUMENT_ERROR`에서 결과. **contactFields** 값 `"*"` 모든 연락처 필드를 검색 합니다.
+
+**contactFindOptions.filter** 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 **contactFields** 매개 변수에 지정 된 각 필드에 적용 됩니다. *모든* 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 **contactFindOptions.desiredFields** 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
+
+### 매개 변수
+
+  * **contactFields**: 검색 한정자로 사용 하는 필드에 문의. *(DOMString[])* [Required]
+
+  * **contactSuccess**: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [Required]
+
+  * **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+  * **contactFindOptions**: navigator.contacts 필터링 옵션을 검색 합니다. [Optional]
+    
+    키 다음과 같습니다.
+    
+      * **filter**: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. *(DOMString)* (기본: `""`)
+    
+      * **multiple**: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. *(부울)* (기본값: `false`)
+        
+          * **desiredFields**: 연락처 필드를 다시 반환 합니다. 지정 된 경우 결과 `Contact` 기능 값만이 필드 개체입니다. *(DOMString[])* [Optional]
+
+### 지원 되는 플랫폼
+
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+  * 윈도 (Windows Phone 8.1, 윈도 10)
+
+### 예를 들어
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### 윈도우 특수
+
+  * `__contactFields__`지원 되지 않으며 무시 됩니다. `find`메서드가 항상 이름, 이메일 주소 또는 연락처의 전화 번호를 일치 하도록 시도 합니다.
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact` 메서드를 사용 하면 단일 연락처 선택 문의 선택 시작 합니다. 결과 개체는 **contactSuccess** 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.
+
+### 매개 변수
+
+  * **contactSuccess**: 단일 연락처 개체와 호출 되는 성공 콜백 함수. [필수]
+
+  * **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+### 지원 되는 플랫폼
+
+  * 안 드 로이드
+  * iOS
+  * Windows Phone 8
+  * 윈도우 8
+  * 윈도우
+
+### 예를 들어
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## 연락처
+
+`Contact` 개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 `navigator.contacts.find` 메서드를 호출 하 여.
+
+**참고**: 모든 연락처 필드 위에 나열 된 모든 장치 플랫폼에서 지원 됩니다. 자세한 내용은 각 플랫폼의 *단점이* 섹션을 확인 하시기 바랍니다.
+
+### 속성
+
+  * **id**: 글로벌 고유 식별자. *(DOMString)*
+
+  * **displayName**: 최종 사용자에 게 표시에 적합이 연락처의 이름. *(DOMString)*
+
+  * **이름**: 사람 이름의 모든 구성 요소를 포함 하는 개체. *(담당자 이름)*
+
+  * **별명**: 캐주얼 이름 연락처 주소입니다. *(DOMString)*
+
+  * **phoneNumbers**: 모든 연락처의 전화 번호의 배열. *(ContactField[])*
+
+  * **이메일**: 모든 연락처의 전자 메일 주소의 배열. *(ContactField[])*
+
+  * **주소**: 모든 연락처의 주소 배열. *(ContactAddress[])*
+
+  * **ims**: 모든 연락처의 IM 주소 배열. *(ContactField[])*
+
+  * **조직**: 다양 한 모든 연락처의 조직. *(ContactOrganization[])*
+
+  * **생일**: 연락처의 생일. *(날짜)*
+
+  * **참고**: 연락처에 대 한 참고. *(DOMString)*
+
+  * **사진**: 연락처의 사진을 배열. *(ContactField[])*
+
+  * **카테고리**: 모든 사용자 정의 범주 연락처에 연결 된 배열. *(ContactField[])*
+
+  * **url**: 연락처에 연결 된 웹 페이지의 배열. *(ContactField[])*
+
+### 메서드
+
+  * **복제**: 새로운 반환 합니다 `Contact` 으로 호출 하는 개체의 전체 복사본은 개체는 `id` 속성으로 설정`null`.
+
+  * **제거**: 장치 연락처 데이터베이스에서 연락처를 제거 합니다, 그렇지 않으면와 오류 콜백을 실행 한 `ContactError` 개체.
+
+  * **저장**: 장치 연락처 데이터베이스를 새 연락처를 저장 또는 동일한 **id** 를 가진 연락처가 이미 있는 경우 기존 연락처를 업데이트 합니다.
+
+### 지원 되는 플랫폼
+
+  * 아마존 화재 운영 체제
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+  * 윈도우 8
+  * 윈도우
+
+### 예를 들어 저장
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### 복제 예제
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### 예제 제거
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### 안 드 로이드 2.X 단점
+
+  * **카테고리**: 안 드 로이드 2.X 장치, 반환에서 지원 되지 않습니다`null`.
+
+### 블랙베리 10 단점
+
+  * **id**: 연락처를 저장 하면 장치에 할당 합니다.
+
+### FirefoxOS 특수
+
+  * **카테고리**: 부분적으로 지원 합니다. 필드 **pref** 및 **형식** 반환`null`
+
+  * **ims**: 지원 되지 않음
+
+  * **사진**: 지원 되지 않음
+
+### iOS 단점
+
+  * **displayName**: 반환 iOS에서 지원 되지 않는 `null` 가 아무 `ContactName` 지정 된,이 경우 복합 이름, **닉네임** 을 반환 합니다 또는 `""` , 각각.
+
+  * **생일**: 자바 스크립트로 입력 해야 합니다 `Date` 개체를 같은 방식으로 반환 됩니다.
+
+  * **사진**: 응용 프로그램의 임시 디렉터리에 저장 된 이미지 파일 URL을 반환 합니다. 응용 프로그램이 종료 될 때 임시 디렉터리의 내용은 제거 됩니다.
+
+  * **카테고리**:이 속성은 현재 지원 되지 않습니다, 반환`null`.
+
+### Windows Phone 7, 8 특수
+
+  * **displayName**: 연락처를 만들 때 표시 이름에서 표시 이름 매개 변수 다릅니다 제공 값 검색 연락처를 찾을 때.
+
+  * **url**: 연락처를 만들 때 사용자가 입력을 하나 이상의 웹 주소를 저장 하지만 하나만 사용할 수 있는 연락처를 검색할 때.
+
+  * **phoneNumbers**: *pref* 옵션이 지원 되지 않습니다. *형식* *찾기* 작업에서 지원 되지 않습니다. 단 하나 `phoneNumber` 각 *형식* 에 대 한 허용.
+
+  * **이메일**: *pref* 옵션이 지원 되지 않습니다. 가정 및 개인 동일한 이메일 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+  * **주소**: 직장, 및 가정/개인 *유형*을 지원 합니다. 가정 및 개인 *유형* 동일한 주소 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+  * **조직**: 하나만 허용 되 고 *pref*, *유형*및 *부서* 특성을 지원 하지 않습니다.
+
+  * **참고**: 지원 되지 않는 반환`null`.
+
+  * **ims**: 지원 되지 않는 반환`null`.
+
+  * **생일**: 지원 되지 않는 반환`null`.
+
+  * **카테고리**: 지원 되지 않는 반환`null`.
+
+  * **제거**: 메서드가 지원 되지 않습니다
+
+### 윈도우 특수
+
+  * **사진**: 응용 프로그램의 임시 디렉터리에 저장 된 이미지 파일 URL을 반환 합니다.
+
+  * **생일**: 지원 되지 않는 반환`null`.
+
+  * **카테고리**: 지원 되지 않는 반환`null`.
+
+  * **제거**: 메서드는 Windows 10 이상 에서만 지원 됩니다.
+
+## ContactAddress
+
+`ContactAddress` 개체는 연락처의 단일 주소 속성을 저장합니다. `연락처` 개체는 `ContactAddress` 배열에 있는 하나 이상의 주소를 포함할 수 있습니다.
+
+### 속성
+
+  * **pref**: 설정 `true` 이 경우 `ContactAddress` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+  * **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열. *(DOMString)*
+
+  * **포맷**: 전체 주소 표시를 위해 서식이 지정 된. *(DOMString)*
+
+  * **streetAddress**: 전체 주소. *(DOMString)*
+
+  * **지역**: 구, 군 또는 도시. *(DOMString)*
+
+  * **지역**: 상태 또는 지역. *(DOMString)*
+
+  * **postalCode**: 우편 번호 또는 우편 번호. *(DOMString)*
+
+  * **국가**: 국가 이름. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+  * 아마존 화재 운영 체제
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+  * 윈도우 8
+  * 윈도우
+
+### 예를 들어
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### 안 드 로이드 2.X 단점
+
+  * **pref**: 지원 되지 않는 반환 `false` 안 드 로이드 2.X 장치에.
+
+### 블랙베리 10 단점
+
+  * **pref**: 반환 BlackBerry 장치에서 지원 되지 않습니다`false`.
+
+  * **유형**: 부분적으로 지원 합니다. *작업* 및 *홈* 형식 주소 각 단 하나 접촉 당 저장할 수 있습니다.
+
+  * **포맷**: 부분적으로 지원 합니다. 모든 검은 딸기 주소 필드의 연결을 반환합니다.
+
+  * **streetAddress**: 지원. 블랙베리 **address1** **주소 2** 의 연결 주소 필드를 반환합니다.
+
+  * **지역**: 지원. 블랙베리 **시** 주소 필드에 저장 합니다.
+
+  * **지역**: 지원. 블랙베리 **stateProvince** 주소 필드에 저장 합니다.
+
+  * **postalCode**: 지원. 블랙베리 **zipPostal** 주소 필드에 저장 합니다.
+
+  * **국가**: 지원.
+
+### FirefoxOS 특수
+
+  * **포맷**: 현재 지원 되지 않습니다
+
+### iOS 단점
+
+  * **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+  * **포맷**: 현재 지원 되지 않습니다.
+
+### 윈도우 8 단점
+
+  * **pref**: 지원 되지 않음
+
+### 윈도우 특수
+
+  * **pref**: 지원 되지 않음
+
+## ContactError
+
+`ContactError` 개체는 오류가 발생 하면 `contactError` 콜백 함수를 통해 사용자에 게 반환 됩니다.
+
+### 속성
+
+  * **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
+
+### 상수
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField` 개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의입니다. 각 `ContactField` 개체에는 `value`, `type` 및 `pref` 속성을 포함 되어 있습니다. `Contact` 개체는 전화 번호 및 이메일 주소와 같은 `ContactField` 배열에서 몇 가지 속성을 저장합니다.
+
+대부분의 경우에서는 `ContactField` 개체의 **type** 속성에 대 한 미리 정해진된 값이 없습니다. 예를 들어 전화 번호 *홈*, *작품*, *모바일*, *아이폰* 또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 **유형** 값을 지정할 수 있습니다. 그러나, `연락처` **사진** 필드 **유형** 필드 나타냅니다 반환 된 이미지 형식: **url** **값** 특성 **값** 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 *base64* URL이 포함 된 경우.
+
+### 속성
+
+  * **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. *(DOMString)*
+
+  * **값**: 전화 번호 또는 이메일 주소와 같은 필드 값. *(DOMString)*
+
+  * **pref**: 설정 `true` 이 경우 `ContactField` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+### 지원 되는 플랫폼
+
+  * 아마존 화재 운영 체제
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+  * 윈도우 8
+  * 윈도우
+
+### 예를 들어
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### 안 드 로이드 단점
+
+  * **pref**: 지원 되지 않는 반환`false`.
+
+### 블랙베리 10 단점
+
+  * **유형**: 부분적으로 지원 합니다. 전화 번호에 대 한 사용.
+
+  * **값**: 지원.
+
+  * **pref**: 지원 되지 않는 반환`false`.
+
+### iOS 단점
+
+  * **pref**: 지원 되지 않는 반환`false`.
+
+### Windows8 단점
+
+  * **pref**: 지원 되지 않는 반환`false`.
+
+### 윈도우 특수
+
+  * **pref**: 지원 되지 않는 반환`false`.
+
+## 담당자 이름
+
+여러 종류의 `Contact` 개체의 이름에 대 한 정보를 포함합니다.
+
+### 속성
+
+  * **포맷**: 연락처의 전체 이름. *(DOMString)*
+
+  * **familyName**: 연락처의 성. *(DOMString)*
+
+  * **givenName**: 연락처의 이름. *(DOMString)*
+
+  * **middleName**: 연락처의 중간 이름을. *(DOMString)*
+
+  * **honorificPrefix**: 연락처의 접두사 (예: *미스터* 또는 *닥터*) *(DOMString)*
+
+  * **honorificSuffix**: 연락처의 접미사 ( *esq.*예). *(DOMString)*
+
+### 지원 되는 플랫폼
+
+  * 아마존 화재 운영 체제
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+  * 윈도우 8
+  * 윈도우
+
+### 예를 들어
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### 안 드 로이드 단점
+
+  * **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### 블랙베리 10 단점
+
+  * **포맷**: 부분적으로 지원 합니다. 블랙베리 **firstName** 및 **lastName** 필드의 연결을 반환합니다.
+
+  * **familyName**: 지원. 블랙베리 **lastName** 필드에 저장 합니다.
+
+  * **givenName**: 지원. 블랙베리 **firstName** 필드에 저장 합니다.
+
+  * **middleName**: 지원 되지 않는 반환`null`.
+
+  * **honorificPrefix**: 지원 되지 않는 반환`null`.
+
+  * **honorificSuffix**: 지원 되지 않는 반환`null`.
+
+### FirefoxOS 특수
+
+  * **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### iOS 단점
+
+  * **포맷**: 부분적으로 지원 합니다. IOS 복합 이름 반환 하지만 읽기 전용입니다.
+
+### 윈도우 8 단점
+
+  * **형식**: 이것은 유일한 속성 이름과 동일 하다 `displayName` , 및`nickname`
+
+  * **familyName**: 지원 되지 않음
+
+  * **givenName**: 지원 되지 않음
+
+  * **middleName**: 지원 되지 않음
+
+  * **honorificPrefix**: 지원 되지 않음
+
+  * **honorificSuffix**: 지원 되지 않음
+
+### 윈도우 특수
+
+  * **형식**: 그것은 동일`displayName`
+
+## ContactOrganization
+
+`ContactOrganization` 개체는 연락처의 조직 속성을 저장합니다. `Contact` 개체 배열에 하나 이상의 `ContactOrganization` 개체를 저장합니다.
+
+### 속성
+
+  * **pref**: 설정 `true` 이 경우 `ContactOrganization` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+  * **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. _(DOMString)
+
+  * **이름**: 조직 이름. *(DOMString)*
+
+  * **부서**: 계약을 위해 일 하는 부서. *(DOMString)*
+
+  * **제목**: 조직에서 연락처의 제목. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+  * 안 드 로이드
+  * 블랙베리 10
+  * Firefox 운영 체제
+  * iOS
+  * Windows Phone 7과 8
+  * 윈도우 (Windows 8.1와 Windows Phone 8.1 소자만 해당)
+
+### 예를 들어
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### 안 드 로이드 2.X 단점
+
+  * **pref**: 반환 안 드 로이드 2.X 장치에 의해 지원 되지 않습니다`false`.
+
+### 블랙베리 10 단점
+
+  * **pref**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`false`.
+
+  * **유형**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`null`.
+
+  * **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름 블랙베리 **회사** 필드에 저장 됩니다.
+
+  * **부서**: 지원 되지 않는 반환`null`.
+
+  * **제목**: 부분적으로 지원 합니다. 첫 번째 조직 제목 블랙베리 **jobTitle** 필드에 저장 됩니다.
+
+### 파이어 폭스 OS 단점
+
+  * **pref**: 지원 되지 않음
+
+  * **형식**: 지원 되지 않음
+
+  * **부서**: 지원 되지 않음
+
+  * 필드 **이름** 및 **제목** **org** 및 **jobTitle** 에 저장.
+
+### iOS 단점
+
+  * **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+  * **유형**: 반환 하는 iOS 장치에서 지원 되지 않습니다`null`.
+
+  * **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름은 iOS **kABPersonOrganizationProperty** 필드에 저장 됩니다.
+
+  * **부서**: 부분적으로 지원 합니다. 첫 번째 부서 이름은 iOS **kABPersonDepartmentProperty** 필드에 저장 됩니다.
+
+  * **제목**: 부분적으로 지원 합니다. 첫 번째 타이틀 iOS **kABPersonJobTitleProperty** 필드에 저장 됩니다.
+
+### 윈도우 특수
+
+  * **pref**: 지원 되지 않는 반환`false`.
+
+  * **형식**: 지원 되지 않는 반환`null`.

km0App/node_modules/cordova-plugin-contacts/doc/ko/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+이 플러그인 장치 연락처 데이터베이스에 대 한 액세스를 제공 하는 글로벌 `navigator.contacts` 개체를 정의 합니다.
+
+개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**경고**: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서, 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강력 하 게 고려해 야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, **확인** 및 **아니오** 선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세스 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
+
+## 설치
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### 파이어 폭스 OS 단점
+
+[참고 문서][1]에 설명 된 대로 **www/manifest.webapp**를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "privileged"-webapp 유형을 변경 하려면 필요가 하다. **경고**: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3]을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### 윈도우 특수
+
+`find` 및 `pickContact` 메서드에서 반환 하는 모든 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다. `찾을` 방법은 Windows Phone 8.1 장치에만 사용할 수 있습니다.
+
+### 윈도우 8 단점
+
+윈도우 8 연락처는 읽기 전용입니다. 코르 도우 바 API 연락처를 통해 하지 쿼리/검색할 수 있습니다, 사용자 알려 '사람' 애플 리 케이 션을 열 것 이다 contacts.pickContact에 대 한 호출으로 연락처를 선택 하 여 사용자 연락처를 선택 해야 합니다. 반환 된 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다.
+
+## navigator.contacts
+
+### 메서드
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### 개체
+
+*   연락처
+*   담당자 이름
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create` 메서드는 동기적 및 새 `연락처` 개체를 반환 합니다.
+
+이 메서드는 `Contact.save` 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다.
+
+### 지원 되는 플랫폼
+
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+
+### 예를 들어
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+장치 연락처 데이터베이스 쿼리 및 `Contact` 개체의 배열을 반환 `navigator.contacts.find` 메서드를 비동기적으로 실행 합니다. 결과 개체는 **contactSuccess** 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.
+
+**contactFields** 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 **contactFields** 매개 변수가 유효 하 고 `ContactError.INVALID_ARGUMENT_ERROR`에서 결과. **contactFields** 값 `"*"` 모든 연락처 필드를 검색 합니다.
+
+**contactFindOptions.filter** 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 **contactFields** 매개 변수에 지정 된 각 필드에 적용 됩니다. *모든* 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 **contactFindOptions.desiredFields** 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
+
+### 매개 변수
+
+*   **contactFields**: 검색 한정자로 사용 하는 필드에 문의. *(DOMString[])* [Required]
+
+*   **contactSuccess**: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [Required]
+
+*   **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+*   **contactFindOptions**: navigator.contacts 필터링 옵션을 검색 합니다. [Optional]
+    
+    키 다음과 같습니다.
+    
+    *   **filter**: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. *(DOMString)* (기본: `""`)
+    
+    *   **multiple**: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. *(부울)* (기본값: `false`)
+        
+        *   **desiredFields**: 연락처 필드를 다시 반환 합니다. 지정 된 경우 결과 `Contact` 기능 값만이 필드 개체입니다. *(DOMString[])* [Optional]
+
+### 지원 되는 플랫폼
+
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+*   윈도우 (Windows Phone 8.1 소자만 해당)
+
+### 예를 들어
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### 윈도우 특수
+
+*   `__contactFields__`지원 되지 않으며 무시 됩니다. `find`메서드가 항상 이름, 이메일 주소 또는 연락처의 전화 번호를 일치 하도록 시도 합니다.
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact` 메서드를 사용 하면 단일 연락처 선택 문의 선택 시작 합니다. 결과 개체는 **contactSuccess** 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.
+
+### 매개 변수
+
+*   **contactSuccess**: 단일 연락처 개체와 호출 되는 성공 콜백 함수. [필수]
+
+*   **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+### 지원 되는 플랫폼
+
+*   안 드 로이드
+*   iOS
+*   Windows Phone 8
+*   윈도우 8
+*   윈도우
+
+### 예를 들어
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## 연락처
+
+`Contact` 개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 `navigator.contacts.find` 메서드를 호출 하 여.
+
+**참고**: 모든 연락처 필드 위에 나열 된 모든 장치 플랫폼에서 지원 됩니다. 자세한 내용은 각 플랫폼의 *단점이* 섹션을 확인 하시기 바랍니다.
+
+### 속성
+
+*   **id**: 글로벌 고유 식별자. *(DOMString)*
+
+*   **displayName**: 최종 사용자에 게 표시에 적합이 연락처의 이름. *(DOMString)*
+
+*   **이름**: 사람 이름의 모든 구성 요소를 포함 하는 개체. *(담당자 이름)*
+
+*   **별명**: 캐주얼 이름 연락처 주소입니다. *(DOMString)*
+
+*   **phoneNumbers**: 모든 연락처의 전화 번호의 배열. *(ContactField[])*
+
+*   **이메일**: 모든 연락처의 전자 메일 주소의 배열. *(ContactField[])*
+
+*   **주소**: 모든 연락처의 주소 배열. *(ContactAddress[])*
+
+*   **ims**: 모든 연락처의 IM 주소 배열. *(ContactField[])*
+
+*   **조직**: 다양 한 모든 연락처의 조직. *(ContactOrganization[])*
+
+*   **생일**: 연락처의 생일. *(날짜)*
+
+*   **참고**: 연락처에 대 한 참고. *(DOMString)*
+
+*   **사진**: 연락처의 사진을 배열. *(ContactField[])*
+
+*   **카테고리**: 모든 사용자 정의 범주 연락처에 연결 된 배열. *(ContactField[])*
+
+*   **url**: 연락처에 연결 된 웹 페이지의 배열. *(ContactField[])*
+
+### 메서드
+
+*   **복제**: 새로운 반환 합니다 `Contact` 으로 호출 하는 개체의 전체 복사본은 개체는 `id` 속성으로 설정`null`.
+
+*   **제거**: 장치 연락처 데이터베이스에서 연락처를 제거 합니다, 그렇지 않으면와 오류 콜백을 실행 한 `ContactError` 개체.
+
+*   **저장**: 장치 연락처 데이터베이스를 새 연락처를 저장 또는 동일한 **id** 를 가진 연락처가 이미 있는 경우 기존 연락처를 업데이트 합니다.
+
+### 지원 되는 플랫폼
+
+*   아마존 화재 운영 체제
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+*   윈도우 8
+*   윈도우
+
+### 예를 들어 저장
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### 복제 예제
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### 예제 제거
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### 안 드 로이드 2.X 단점
+
+*   **카테고리**: 안 드 로이드 2.X 장치, 반환에서 지원 되지 않습니다`null`.
+
+### 블랙베리 10 단점
+
+*   **id**: 연락처를 저장 하면 장치에 할당 합니다.
+
+### FirefoxOS 특수
+
+*   **카테고리**: 부분적으로 지원 합니다. 필드 **pref** 및 **형식** 반환`null`
+
+*   **ims**: 지원 되지 않음
+
+*   **사진**: 지원 되지 않음
+
+### iOS 단점
+
+*   **displayName**: 반환 iOS에서 지원 되지 않는 `null` 가 아무 `ContactName` 지정 된,이 경우 복합 이름, **닉네임** 을 반환 합니다 또는 `""` , 각각.
+
+*   **생일**: 자바 스크립트로 입력 해야 합니다 `Date` 개체를 같은 방식으로 반환 됩니다.
+
+*   **사진**: 응용 프로그램의 임시 디렉터리에 저장 된 이미지 파일 URL을 반환 합니다. 응용 프로그램이 종료 될 때 임시 디렉터리의 내용은 제거 됩니다.
+
+*   **카테고리**:이 속성은 현재 지원 되지 않습니다, 반환`null`.
+
+### Windows Phone 7, 8 특수
+
+*   **displayName**: 연락처를 만들 때 표시 이름에서 표시 이름 매개 변수 다릅니다 제공 값 검색 연락처를 찾을 때.
+
+*   **url**: 연락처를 만들 때 사용자가 입력을 하나 이상의 웹 주소를 저장 하지만 하나만 사용할 수 있는 연락처를 검색할 때.
+
+*   **phoneNumbers**: *pref* 옵션이 지원 되지 않습니다. *형식* *찾기* 작업에서 지원 되지 않습니다. 단 하나 `phoneNumber` 각 *형식* 에 대 한 허용.
+
+*   **이메일**: *pref* 옵션이 지원 되지 않습니다. 가정 및 개인 동일한 이메일 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+*   **주소**: 직장, 및 가정/개인 *유형*을 지원 합니다. 가정 및 개인 *유형* 동일한 주소 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+*   **조직**: 하나만 허용 되 고 *pref*, *유형*및 *부서* 특성을 지원 하지 않습니다.
+
+*   **참고**: 지원 되지 않는 반환`null`.
+
+*   **ims**: 지원 되지 않는 반환`null`.
+
+*   **생일**: 지원 되지 않는 반환`null`.
+
+*   **카테고리**: 지원 되지 않는 반환`null`.
+
+### 윈도우 특수
+
+*   **사진**: 응용 프로그램의 임시 디렉터리에 저장 된 이미지 파일 URL을 반환 합니다.
+
+*   **생일**: 지원 되지 않는 반환`null`.
+
+*   **카테고리**: 지원 되지 않는 반환`null`.
+
+## ContactAddress
+
+`ContactAddress` 개체는 연락처의 단일 주소 속성을 저장합니다. `연락처` 개체는 `ContactAddress` 배열에 있는 하나 이상의 주소를 포함할 수 있습니다.
+
+### 속성
+
+*   **pref**: 설정 `true` 이 경우 `ContactAddress` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+*   **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열. *(DOMString)*
+
+*   **포맷**: 전체 주소 표시를 위해 서식이 지정 된. *(DOMString)*
+
+*   **streetAddress**: 전체 주소. *(DOMString)*
+
+*   **지역**: 구, 군 또는 도시. *(DOMString)*
+
+*   **지역**: 상태 또는 지역. *(DOMString)*
+
+*   **postalCode**: 우편 번호 또는 우편 번호. *(DOMString)*
+
+*   **국가**: 국가 이름. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+*   아마존 화재 운영 체제
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+*   윈도우 8
+*   윈도우
+
+### 예를 들어
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### 안 드 로이드 2.X 단점
+
+*   **pref**: 지원 되지 않는 반환 `false` 안 드 로이드 2.X 장치에.
+
+### 블랙베리 10 단점
+
+*   **pref**: 반환 BlackBerry 장치에서 지원 되지 않습니다`false`.
+
+*   **유형**: 부분적으로 지원 합니다. *작업* 및 *홈* 형식 주소 각 단 하나 접촉 당 저장할 수 있습니다.
+
+*   **포맷**: 부분적으로 지원 합니다. 모든 검은 딸기 주소 필드의 연결을 반환합니다.
+
+*   **streetAddress**: 지원. 블랙베리 **address1** **주소 2** 의 연결 주소 필드를 반환합니다.
+
+*   **지역**: 지원. 블랙베리 **시** 주소 필드에 저장 합니다.
+
+*   **지역**: 지원. 블랙베리 **stateProvince** 주소 필드에 저장 합니다.
+
+*   **postalCode**: 지원. 블랙베리 **zipPostal** 주소 필드에 저장 합니다.
+
+*   **국가**: 지원.
+
+### FirefoxOS 특수
+
+*   **포맷**: 현재 지원 되지 않습니다
+
+### iOS 단점
+
+*   **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+*   **포맷**: 현재 지원 되지 않습니다.
+
+### 윈도우 8 단점
+
+*   **pref**: 지원 되지 않음
+
+### 윈도우 특수
+
+*   **pref**: 지원 되지 않음
+
+## ContactError
+
+`ContactError` 개체는 오류가 발생 하면 `contactError` 콜백 함수를 통해 사용자에 게 반환 됩니다.
+
+### 속성
+
+*   **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
+
+### 상수
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField` 개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의입니다. 각 `ContactField` 개체에는 `value`, `type` 및 `pref` 속성을 포함 되어 있습니다. `Contact` 개체는 전화 번호 및 이메일 주소와 같은 `ContactField` 배열에서 몇 가지 속성을 저장합니다.
+
+대부분의 경우에서는 `ContactField` 개체의 **type** 속성에 대 한 미리 정해진된 값이 없습니다. 예를 들어 전화 번호 *홈*, *작품*, *모바일*, *아이폰* 또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 **유형** 값을 지정할 수 있습니다. 그러나, `연락처` **사진** 필드 **유형** 필드 나타냅니다 반환 된 이미지 형식: **url** **값** 특성 **값** 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 *base64* URL이 포함 된 경우.
+
+### 속성
+
+*   **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. *(DOMString)*
+
+*   **값**: 전화 번호 또는 이메일 주소와 같은 필드 값. *(DOMString)*
+
+*   **pref**: 설정 `true` 이 경우 `ContactField` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+### 지원 되는 플랫폼
+
+*   아마존 화재 운영 체제
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+*   윈도우 8
+*   윈도우
+
+### 예를 들어
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### 안 드 로이드 단점
+
+*   **pref**: 지원 되지 않는 반환`false`.
+
+### 블랙베리 10 단점
+
+*   **유형**: 부분적으로 지원 합니다. 전화 번호에 대 한 사용.
+
+*   **값**: 지원.
+
+*   **pref**: 지원 되지 않는 반환`false`.
+
+### iOS 단점
+
+*   **pref**: 지원 되지 않는 반환`false`.
+
+### Windows8 단점
+
+*   **pref**: 지원 되지 않는 반환`false`.
+
+### 윈도우 특수
+
+*   **pref**: 지원 되지 않는 반환`false`.
+
+## 담당자 이름
+
+여러 종류의 `Contact` 개체의 이름에 대 한 정보를 포함합니다.
+
+### 속성
+
+*   **포맷**: 연락처의 전체 이름. *(DOMString)*
+
+*   **familyName**: 연락처의 성. *(DOMString)*
+
+*   **givenName**: 연락처의 이름. *(DOMString)*
+
+*   **middleName**: 연락처의 중간 이름을. *(DOMString)*
+
+*   **honorificPrefix**: 연락처의 접두사 (예: *미스터* 또는 *닥터*) *(DOMString)*
+
+*   **honorificSuffix**: 연락처의 접미사 ( *esq.*예). *(DOMString)*
+
+### 지원 되는 플랫폼
+
+*   아마존 화재 운영 체제
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+*   윈도우 8
+*   윈도우
+
+### 예를 들어
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### 안 드 로이드 단점
+
+*   **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### 블랙베리 10 단점
+
+*   **포맷**: 부분적으로 지원 합니다. 블랙베리 **firstName** 및 **lastName** 필드의 연결을 반환합니다.
+
+*   **familyName**: 지원. 블랙베리 **lastName** 필드에 저장 합니다.
+
+*   **givenName**: 지원. 블랙베리 **firstName** 필드에 저장 합니다.
+
+*   **middleName**: 지원 되지 않는 반환`null`.
+
+*   **honorificPrefix**: 지원 되지 않는 반환`null`.
+
+*   **honorificSuffix**: 지원 되지 않는 반환`null`.
+
+### FirefoxOS 특수
+
+*   **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### iOS 단점
+
+*   **포맷**: 부분적으로 지원 합니다. IOS 복합 이름 반환 하지만 읽기 전용입니다.
+
+### 윈도우 8 단점
+
+*   **형식**: 이것은 유일한 속성 이름과 동일 하다 `displayName` , 및`nickname`
+
+*   **familyName**: 지원 되지 않음
+
+*   **givenName**: 지원 되지 않음
+
+*   **middleName**: 지원 되지 않음
+
+*   **honorificPrefix**: 지원 되지 않음
+
+*   **honorificSuffix**: 지원 되지 않음
+
+### 윈도우 특수
+
+*   **형식**: 그것은 동일`displayName`
+
+## ContactOrganization
+
+`ContactOrganization` 개체는 연락처의 조직 속성을 저장합니다. `Contact` 개체 배열에 하나 이상의 `ContactOrganization` 개체를 저장합니다.
+
+### 속성
+
+*   **pref**: 설정 `true` 이 경우 `ContactOrganization` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+*   **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. _(DOMString)
+
+*   **이름**: 조직 이름. *(DOMString)*
+
+*   **부서**: 계약을 위해 일 하는 부서. *(DOMString)*
+
+*   **제목**: 조직에서 연락처의 제목. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+*   안 드 로이드
+*   블랙베리 10
+*   Firefox 운영 체제
+*   iOS
+*   Windows Phone 7과 8
+*   윈도우 (Windows 8.1와 Windows Phone 8.1 소자만 해당)
+
+### 예를 들어
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### 안 드 로이드 2.X 단점
+
+*   **pref**: 반환 안 드 로이드 2.X 장치에 의해 지원 되지 않습니다`false`.
+
+### 블랙베리 10 단점
+
+*   **pref**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`false`.
+
+*   **유형**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`null`.
+
+*   **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름 블랙베리 **회사** 필드에 저장 됩니다.
+
+*   **부서**: 지원 되지 않는 반환`null`.
+
+*   **제목**: 부분적으로 지원 합니다. 첫 번째 조직 제목 블랙베리 **jobTitle** 필드에 저장 됩니다.
+
+### 파이어 폭스 OS 단점
+
+*   **pref**: 지원 되지 않음
+
+*   **형식**: 지원 되지 않음
+
+*   **부서**: 지원 되지 않음
+
+*   필드 **이름** 및 **제목** **org** 및 **jobTitle** 에 저장.
+
+### iOS 단점
+
+*   **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+*   **유형**: 반환 하는 iOS 장치에서 지원 되지 않습니다`null`.
+
+*   **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름은 iOS **kABPersonOrganizationProperty** 필드에 저장 됩니다.
+
+*   **부서**: 부분적으로 지원 합니다. 첫 번째 부서 이름은 iOS **kABPersonDepartmentProperty** 필드에 저장 됩니다.
+
+*   **제목**: 부분적으로 지원 합니다. 첫 번째 타이틀 iOS **kABPersonJobTitleProperty** 필드에 저장 됩니다.
+
+### 윈도우 특수
+
+*   **pref**: 지원 되지 않는 반환`false`.
+
+*   **형식**: 지원 되지 않는 반환`null`.

km0App/node_modules/cordova-plugin-contacts/doc/pl/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Ten plugin definiuje obiekt globalny `navigator.contacts`, która zapewnia dostęp do bazy danych kontaktów urządzenia.
+
+Mimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**Ostrzeżenie**: zbierania i wykorzystywania danych kontaktowych podnosi kwestie prywatności ważne. Polityka prywatności danej aplikacji należy Dyskutować, jak aplikacja używa danych kontaktowych i czy jest on dzielony z innymi stronami. Informacje kontaktowe uznaje wrażliwych, ponieważ ukazuje ludzi, z którymi osoba komunikuje się. W związku z tym oprócz aplikacji prywatności, zdecydowanie zaleca się zapewnienie just-in czas wypowiedzenia zanim aplikacja uzyskuje dostęp do lub używa danych kontaktowych, jeśli system operacyjny urządzenia nie robi już. Że ogłoszenie powinno zawierać te same informacje, o których wspomniano powyżej, jak również uzyskanie uprawnienia użytkownika (np. poprzez przedstawianie wyborów **OK** i **Nie dzięki**). Należy pamiętać, że niektóre platformy aplikacji może wymagać aplikacji powiadomienia just-in czas i uzyskać uprawnienia użytkownika przed uzyskaniem dostępu do danych kontaktowych. Jasne i łatwe do zrozumienia użytkownika doświadczenie, wykorzystanie kontaktów danych pomaga uniknąć nieporozumień użytkownik i postrzegane nadużycia danych kontaktowych. Aby uzyskać więcej informacji zobacz przewodnik prywatności.
+
+## Instalacja
+
+Wymaga to cordova 5.0 + (obecny v1.0.0 stabilne)
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+Starsze wersje cordova nadal można zainstalować za pomocą identyfikatora **przestarzałe** (starych v0.2.16)
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+Jest również możliwość instalacji za pośrednictwem repo url bezpośrednio (niestabilny)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### Firefox OS dziwactwa
+
+Tworzenie **www/manifest.webapp**, jak opisano w [Dokumentach Manifest](https://developer.mozilla.org/en-US/Apps/Developing/Manifest). Dodaj odpowiednie permisions. Istnieje również potrzeba zmienić typ webapp do "privileged" - [Manifest dokumenty](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type). **Ostrzeżenie**: wszystkie uprzywilejowany apps egzekwowania [Treści polityki bezpieczeństwa](https://developer.mozilla.org/en-US/Apps/CSP), który zabrania skrypt. Zainicjować aplikacji w inny sposób.
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows dziwactwa
+
+**Przed Windows 10:** Wszelkie kontakty wrócił z metody `znaleźć` i `pickContact` są tylko do odczytu, więc aplikacja nie mogą ich modyfikować. `find` metody dostępne tylko na urządzenia Windows Phone 8.1.
+
+**Windows 10 i powyżej:** Kontakty mogą być zapisane i zostaną zapisane do pamięci lokalnej aplikacji Kontakty. Kontakty mogą również zostaną usunięte.
+
+### Windows 8 dziwactwa
+
+Windows 8 kontaktów są tylko do odczytu. Poprzez kontakty Cordova API są nie queryable/wyszukiwania, należy poinformować użytkownika wybrać kontakt jako wezwanie do contacts.pickContact, która zostanie otwarta aplikacja 'Ludzie', gdzie użytkownik musi wybrać kontakt. Wszelkie kontakty, zwracane są tylko do odczytu, więc aplikacja nie mogą ich modyfikować.
+
+## Navigator.Contacts
+
+### Metody
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### Obiekty
+
+  * Contact
+  * ContactName
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+Metoda `navigator.contacts.create` jest synchroniczna i zwraca nowy obiekt `Contact`.
+
+Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego należy wywołać metodę `Contact.save`.
+
+### Obsługiwane platformy
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+
+### Przykład
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Metoda `navigator.contacts.find` asynchronicznie, wykonuje kwerendy bazy danych kontaktów urządzenia i tablicę obiektów `kontaktów`. Wynikowe obiekty są przekazywane do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr **contactSuccess**.
+
+Parametr **contactFields** Określa pola, które mają być używane jako kwalifikator Szukaj. Zerowej długości **contactFields** parametr jest nieprawidłowy i wyniki w `ContactError.INVALID_ARGUMENT_ERROR`. **ContactFields** wartość `"*"` przeszukuje wszystkie kontakt z pola.
+
+Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy kwerenda bazy danych kontaktów. Jeśli dostarczone, przypadek-niewrażliwe, częściowej wartości mecz jest stosowane do każdego pola określony w parametrze **contactFields**. Jeśli ma odpowiednika dla *każdego* pola określony, zwracany jest kontakt. Użycie **contactFindOptions.desiredFields** parametr do kontroli, które kontakt właściwości muszą zostać zwrócone ponownie.
+
+### Parametry
+
+  * **contactFields**: kontakt z pól do wykorzystania jako kwalifikator Szukaj. *(DOMString[])* [Required]
+
+  * **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z tablicy obiektów kontaktów zwracane z bazy danych. [Required]
+
+  * **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+
+  * **contactFindOptions**: Szukaj opcji filtrowania navigator.contacts. [Optional]
+    
+    Klucze obejmuje:
+    
+      * **filter**: ciąg wyszukiwania umożliwia znalezienie navigator.contacts. *(DOMString)* (Domyślnie: `""`)
+    
+      * **multiple**: określa, czy operacja Znajdź zwraca wiele navigator.contacts. *(Wartość logiczna)* (Domyślnie: `false`)
+        
+          * **desiredFields**: kontakt z pola, aby być zwrócona. Jeśli określony, wynikowy `kontakt` obiekt tylko funkcje wartości tych pól. *(DOMString[])* [Optional]
+
+### Obsługiwane platformy
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+  * Systemu Windows (Windows Phone 8.1 i Windows 10)
+
+### Przykład
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows dziwactwa
+
+  * `__contactFields__`nie jest obsługiwane i zostanie zignorowana. `find`Metoda zawsze będzie próbował dopasować nazwę, adres e-mail lub numer telefonu kontaktu.
+
+## navigator.contacts.pickContact
+
+Metoda `navigator.contacts.pickContact` uruchamia próbnika kontakt, wybierz jeden kontaktem. Wynikowy obiekt jest przekazywany do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr **contactSuccess**.
+
+### Parametry
+
+  * **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z jednego obiektu kontakt. [Wymagane]
+
+  * **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+
+### Obsługiwane platformy
+
+  * Android
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### Przykład
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Contact
+
+`Contact` obiekt reprezentuje informacje kontaktowe. Kontakty mogą być tworzone, przechowywane lub usunięte z bazy danych kontaktów urządzenia. Kontakty można również pobrać (pojedynczo lub zbiorczo) bazy danych przez wywołanie metody `navigator.contacts.find`.
+
+**Uwaga**: nie wszystkie pola kontaktowe wymienione powyżej są obsługiwane na każdej platformie urządzenia. Proszę sprawdzić każdej platformy *dziwactw* sekcji szczegółów.
+
+### Właściwości
+
+  * **Identyfikator**: unikatowy identyfikator globalny. *(DOMString)*
+
+  * **displayName**: Nazwa tego kontaktu, nadaje się do wyświetlania użytkownikom końcowym. *(DOMString)*
+
+  * **Nazwa**: obiekt zawierający wszystkie składniki nazwy osób. *(Przedstawiciel)*
+
+  * **nick**: dorywczo nazwy na adres kontakt. *(DOMString)*
+
+  * **numery telefon≤w**: tablica numerów telefonów kontaktowych. *(ContactField[])*
+
+  * **e-maile**: tablica adresów e-mail kontakt. *(ContactField[])*
+
+  * **adresy**: tablica wszystkie adresy. *(ContactAddress[])*
+
+  * **IMS**: tablica kontakt IM adresy. *(ContactField[])*
+
+  * **organizacje**: tablicy wszystkie kontakty organizacji. *(ContactOrganization[])*
+
+  * **urodziny**: urodziny kontakt. *(Data)*
+
+  * **Uwaga**: Uwaga o kontakt. *(DOMString)*
+
+  * **zdjęcia**: tablica zdjęcia kontaktu. *(ContactField[])*
+
+  * **Kategorie**: tablica wszystkie zdefiniowane przez użytkownika kategorie związane z kontaktem. *(ContactField[])*
+
+  * **adresy URL**: tablicy stron internetowych związanych z kontaktem. *(ContactField[])*
+
+### Metody
+
+  * **klon**: Zwraca nowy `Contact` obiekt, który jest kopią głęboko obiektu wywołującego, z `id` Właściwość zestaw`null`.
+
+  * **Usuń**: usuwa kontakt z bazy danych kontaktów urządzenia, w przeciwnym razie wykonuje błąd wywołania zwrotnego z `ContactError` obiektu.
+
+  * **Zapisz**: zapisuje nowy kontakt do bazy kontaktów urządzenia, lub aktualizacje już istniejący kontakt, jeśli istnieje już kontakt o tym samym **identyfikatorze** .
+
+### Obsługiwane platformy
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+  * Windows 8
+  * Windows
+
+### Zapisz przykład
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Przykład klon
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Remove przykład
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Android 2.X dziwactwa
+
+  * **Kategorie**: nie obsługiwane na urządzeniach Android 2.X, powrót`null`.
+
+### Jeżyna 10 dziwactwa
+
+  * **Identyfikator**: przypisany przez urządzenie podczas zapisywania kontaktu.
+
+### Osobliwości FirefoxOS
+
+  * **Kategorie**: częściowo obsługiwane. Pola **pref** i **Typ** wracają`null`
+
+  * **IMS**: nie obsługiwane
+
+  * **zdjęcia**: nie obsługiwane
+
+### Dziwactwa iOS
+
+  * **displayName**: nie obsługiwane na iOS, powrót `null` chyba jest nie `ContactName` określony, w którym to przypadku zwraca nazwę kompozytowe, **nick** lub `""` , odpowiednio.
+
+  * **urodziny**: należy wpisać jako JavaScript `Date` obiektu, tak samo jest zwracany.
+
+  * **zdjęcia**: zwraca adres URL pliku obrazu, który jest przechowywany w katalogu tymczasowego stosowania. Zawartość katalogu tymczasowe są usuwane, kiedy kończy pracę aplikacji.
+
+  * **Kategorie**: Ta właściwość obecnie jest nie obsługiwane, powrót`null`.
+
+### Windows Phone 7 i 8 dziwactwa
+
+  * **displayName**: podczas tworzenia kontaktu, Źródło wartość podana dla parametru nazwy wyświetlania różni się od nazwy wyświetlanej, gdy znalezienie kontaktu.
+
+  * **adresy URL**: podczas tworzenia kontaktu, użytkownicy mogą wpisać i zapisać więcej niż jeden adres sieci web, ale tylko jeden jest dostępne podczas wyszukiwania kontaktów.
+
+  * **numery telefon≤w**: *pref* opcja nie jest obsługiwana. *Typ* nie jest obsługiwany w operacji *znaleźć* . Jedynym `phoneNumber` jest dozwolone dla każdego *typu*.
+
+  * **e-maile**: *pref* opcja nie jest obsługiwana. Domu i osobiste odwołuje się w tym samym wpisu email. Dla każdego *typu* dozwolone jest tylko jeden wpis.
+
+  * **adresy**: obsługuje tylko pracy i domu/osobisty *typu*. Domowych i osobistych *typu* odwołania tej samej pozycji adres. Dla każdego *typu* dozwolone jest tylko jeden wpis.
+
+  * **organizacje**: tylko jeden jest dozwolone, a nie obsługuje * *pref*, *Typ*i* atrybuty.
+
+  * **Uwaga**: nie obsługiwane, powrót`null`.
+
+  * **IMS**: nie obsługiwane, powrót`null`.
+
+  * **urodziny**: nie obsługiwane, powrót`null`.
+
+  * **Kategorie**: nie obsługiwane, powrót`null`.
+
+  * **remove**: Metoda nie jest obsługiwana
+
+### Windows dziwactwa
+
+  * **zdjęcia**: zwraca adres URL pliku obrazu, który jest przechowywany w katalogu tymczasowego stosowania.
+
+  * **urodziny**: nie obsługiwane, powrót`null`.
+
+  * **Kategorie**: nie obsługiwane, powrót`null`.
+
+  * **remove**: Metoda jest obsługiwana tylko w systemie Windows 10 lub wyżej.
+
+## ContactAddress
+
+Obiekt `ContactAddress` przechowuje właściwości pojedynczego adresu kontaktu. Obiekt `Contact` może zawierać więcej niż jeden adres w tablicy `[ContactAddress]`.
+
+### Właściwości
+
+  * **Pref**: zestaw `true` Jeśli `ContactAddress` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+  * **Typ**: string wskazującą typ pola, *do domu* na przykład. *(DOMString)*
+
+  * **w formacie**: pełny adres w formacie wyświetlania. *(DOMString)*
+
+  * **adres**: pełny adres. *(DOMString)*
+
+  * **miejscowości**: miasta lub miejscowości. *(DOMString)*
+
+  * **region**: Państwo lub region. *(DOMString)*
+
+  * **Kod pocztowy**: kod pocztowy lub kod pocztowy. *(DOMString)*
+
+  * **kraj**: nazwę kraju. *(DOMString)*
+
+### Obsługiwane platformy
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+  * Windows 8
+  * Windows
+
+### Przykład
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X dziwactwa
+
+  * **Pref**: nie obsługiwane, powrót `false` na urządzeniach Android 2.X.
+
+### Jeżyna 10 dziwactwa
+
+  * **Pref**: nie obsługiwane na urządzenia BlackBerry, powrót`false`.
+
+  * **Typ**: częściowo obsługiwane. Tylko jeden z *pracy* i *Strona główna* wpisz adresy mogą być przechowywane na kontakt.
+
+  * **w formacie**: częściowo obsługiwane. Zwraca łączenie wszystkich pól adres BlackBerry.
+
+  * **adres**: obsługiwane. Zwraca łączenie BlackBerry **address1** i **Adres2** pola adresu.
+
+  * **miejscowości**: obsługiwane. Przechowywane w polu adres **miasto** BlackBerry.
+
+  * **region**: obsługiwane. Przechowywane w polu adres **stateProvince** BlackBerry.
+
+  * **Kod pocztowy**: obsługiwane. Przechowywane w polu adres **zipPostal** BlackBerry.
+
+  * **kraj**: obsługiwane.
+
+### Osobliwości FirefoxOS
+
+  * **w formacie**: aktualnie nieobsługiwane
+
+### Dziwactwa iOS
+
+  * **Pref**: nie obsługiwane urządzenia iOS, powrót`false`.
+
+  * **w formacie**: obecnie nie jest obsługiwane.
+
+### Windows 8 dziwactwa
+
+  * **Pref**: nie obsługiwane
+
+### Windows dziwactwa
+
+  * **Pref**: nie obsługiwane
+
+## ContactError
+
+`ContactError` obiekt jest zwracany użytkownikowi za pośrednictwem funkcji wywołania zwrotnego `contactError`, gdy wystąpi błąd.
+
+### Właściwości
+
+  * **Kod**: jeden z kodów błędów wstępnie zdefiniowanych poniżej.
+
+### Stałe
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Obiekt `ContactField` jest składnikiem wielokrotnego użytku, że reprezentuje kontakt pola ogólnie. Każdy obiekt `ContactField` zawiera `wartość`, `Typ` i `pref` Właściwość. Obiekt `Contact` sklepy kilku właściwości w tablicach `[ContactField]`, takich jak numery telefonów i adresy e-mail.
+
+W większości przypadków są nie wcześniej ustalonych wartości atrybutu **type** obiektu `ContactField`. Na przykład numer telefonu można określić **type** wartości *home*, *work*, *mobile*, *iPhone*, lub jakąkolwiek inną wartość, który jest obsługiwany przez platformę danego urządzenia bazy danych kontaktów. Jednak `Contact` **photos** pola, pole **type** wskazuje format zwrócone obrazu: **url**, gdy **value** atrybut zawiera adres URL, do zdjęć, lub *base64*, gdy **value** zawiera ciąg zakodowany base64 obrazu.
+
+### Właściwości
+
+  * **Typ**: ciąg, który wskazuje typ pola, *do domu* , np. *(DOMString)*
+
+  * **wartości**: wartość pola, na przykład adresu e-mail lub numer telefonu. *(DOMString)*
+
+  * **Pref**: zestaw `true` Jeśli `ContactField` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+### Obsługiwane platformy
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+  * Windows 8
+  * Windows
+
+### Przykład
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Dziwactwa Androida
+
+  * **Pref**: nie obsługiwane, powrót`false`.
+
+### Jeżyna 10 dziwactwa
+
+  * **Typ**: częściowo obsługiwane. Używane numery telefonów.
+
+  * **wartość**: obsługiwane.
+
+  * **Pref**: nie obsługiwane, powrót`false`.
+
+### Dziwactwa iOS
+
+  * **Pref**: nie obsługiwane, powrót`false`.
+
+### Osobliwości Windows8
+
+  * **Pref**: nie obsługiwane, powrót`false`.
+
+### Windows dziwactwa
+
+  * **Pref**: nie obsługiwane, powrót`false`.
+
+## ContactName
+
+Zawiera różne rodzaje informacji o nazwę obiektu `Contact`.
+
+### Właściwości
+
+  * **w formacie**: pełną nazwę kontaktu. *(DOMString)*
+
+  * **danych**: nazwisko kontaktu. *(DOMString)*
+
+  * **imię**: imię kontaktu. *(DOMString)*
+
+  * **middleName**: nazwy bliskiego kontaktu. *(DOMString)*
+
+  * **honorificPrefix**: kontakt prefiks (przykład *Pan* lub *Dr*) *(DOMString)*
+
+  * **honorificSuffix**: kontakt sufiks (przykład *Esq.*). *(DOMString)*
+
+### Obsługiwane platformy
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+  * Windows 8
+  * Windows
+
+### Przykład
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Dziwactwa Androida
+
+  * **w formacie**: częściowo obsługiwane i tylko do odczytu. Zwraca składa się z `honorificPrefix` , `givenName` , `middleName` , `familyName` , i`honorificSuffix`.
+
+### Jeżyna 10 dziwactwa
+
+  * **w formacie**: częściowo obsługiwane. Zwraca łączenie pól **imię** i **nazwisko** BlackBerry.
+
+  * **danych**: obsługiwane. Przechowywane w BlackBerry pola **nazwisko** .
+
+  * **imię**: obsługiwane. Przechowywane w polu **imię** BlackBerry.
+
+  * **middleName**: nie obsługiwane, powrót`null`.
+
+  * **honorificPrefix**: nie obsługiwane, powrót`null`.
+
+  * **honorificSuffix**: nie obsługiwane, powrót`null`.
+
+### Osobliwości FirefoxOS
+
+  * **w formacie**: częściowo obsługiwane i tylko do odczytu. Zwraca składa się z `honorificPrefix` , `givenName` , `middleName` , `familyName` , i`honorificSuffix`.
+
+### Dziwactwa iOS
+
+  * **w formacie**: częściowo obsługiwane. Zwraca iOS nazwy, ale jest tylko do odczytu.
+
+### Windows 8 dziwactwa
+
+  * **w formacie**: to jest tylko nazwa właściwość i jest taka sama, jak `displayName` , i`nickname`
+
+  * **danych**: nie obsługiwane
+
+  * **imię**: nie obsługiwane
+
+  * **middleName**: nie obsługiwane
+
+  * **honorificPrefix**: nie obsługiwane
+
+  * **honorificSuffix**: nie obsługiwane
+
+### Windows dziwactwa
+
+  * **w formacie**: jest identyczny z`displayName`
+
+## ContactOrganization
+
+Obiekt `ContactOrganization` przechowuje właściwości organizacji kontaktu. Obiekt `Contact` sklepy jeden lub więcej obiektów `ContactOrganization` w tablicy.
+
+### Właściwości
+
+  * **Pref**: zestaw `true` Jeśli `ContactOrganization` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+  * **Typ**: ciąg, który wskazuje typ pola, *do domu* , np. _(DOMString)
+
+  * **Nazwa**: nazwa organizacji. *(DOMString)*
+
+  * **w departamencie**: dziale umowy działa. *(DOMString)*
+
+  * **tytuł**: tytuł kontaktu w organizacji. *(DOMString)*
+
+### Obsługiwane platformy
+
+  * Android
+  * BlackBerry 10
+  * Firefox OS
+  * iOS
+  * Windows Phone 7 i 8
+  * Windows (tylko urządzenia Windows 8.1 i Windows Phone 8.1)
+
+### Przykład
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X dziwactwa
+
+  * **Pref**: nie obsługiwane przez urządzenia Android 2.X, powrót`false`.
+
+### Jeżyna 10 dziwactwa
+
+  * **Pref**: nie obsługiwane przez urządzenia BlackBerry, powrót`false`.
+
+  * **Typ**: nie obsługiwane przez urządzenia BlackBerry, powrót`null`.
+
+  * **Nazwa**: częściowo obsługiwane. Pierwsza nazwa organizacji są przechowywane w polu **firma** BlackBerry.
+
+  * **w departamencie**: nie obsługiwane, powrót`null`.
+
+  * **tytuł**: częściowo obsługiwane. Pierwszy tytuł organizacji są przechowywane w polu **jobTitle** BlackBerry.
+
+### Firefox OS dziwactwa
+
+  * **Pref**: nie obsługiwane
+
+  * **Typ**: nie obsługiwane
+
+  * **w departamencie**: nie obsługiwane
+
+  * Pola **Nazwa** i **tytuł** przechowywane w **org** i **jobTitle**.
+
+### Dziwactwa iOS
+
+  * **Pref**: nie obsługiwane urządzenia iOS, powrót`false`.
+
+  * **Typ**: nie obsługiwane urządzenia iOS, powrót`null`.
+
+  * **Nazwa**: częściowo obsługiwane. Pierwsza nazwa organizacji są przechowywane w polu **kABPersonOrganizationProperty** iOS.
+
+  * **w departamencie**: częściowo obsługiwane. Pierwsza nazwa jest przechowywana w polu **kABPersonDepartmentProperty** iOS.
+
+  * **tytuł**: częściowo obsługiwane. Pierwszy tytuł jest przechowywany w polu **kABPersonJobTitleProperty** iOS.
+
+### Windows dziwactwa
+
+  * **Pref**: nie obsługiwane, powrót`false`.
+
+  * **Typ**: nie obsługiwane, powrót`null`.

km0App/node_modules/cordova-plugin-contacts/doc/pl/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+Ten plugin definiuje obiekt globalny `navigator.contacts`, która zapewnia dostęp do bazy danych kontaktów urządzenia.
+
+Mimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**Ostrzeżenie**: zbierania i wykorzystywania danych kontaktowych podnosi kwestie prywatności ważne. Polityka prywatności danej aplikacji należy Dyskutować, jak aplikacja używa danych kontaktowych i czy jest on dzielony z innymi stronami. Informacje kontaktowe uznaje wrażliwych, ponieważ ukazuje ludzi, z którymi osoba komunikuje się. W związku z tym oprócz aplikacji prywatności, zdecydowanie zaleca się zapewnienie just-in czas wypowiedzenia zanim aplikacja uzyskuje dostęp do lub używa danych kontaktowych, jeśli system operacyjny urządzenia nie robi już. Że ogłoszenie powinno zawierać te same informacje, o których wspomniano powyżej, jak również uzyskanie uprawnienia użytkownika (np. poprzez przedstawianie wyborów **OK** i **Nie dzięki**). Należy pamiętać, że niektóre platformy aplikacji może wymagać aplikacji powiadomienia just-in czas i uzyskać uprawnienia użytkownika przed uzyskaniem dostępu do danych kontaktowych. Jasne i łatwe do zrozumienia użytkownika doświadczenie, wykorzystanie kontaktów danych pomaga uniknąć nieporozumień użytkownik i postrzegane nadużycia danych kontaktowych. Aby uzyskać więcej informacji zobacz przewodnik prywatności.
+
+## Instalacja
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### Firefox OS dziwactwa
+
+Tworzenie **www/manifest.webapp**, jak opisano w [Dokumentach Manifest][1]. Dodaj odpowiednie permisions. Istnieje również potrzeba zmienić typ webapp do "privileged" - [Manifest dokumenty][2]. **Ostrzeżenie**: wszystkie uprzywilejowany apps egzekwowania [Treści polityki bezpieczeństwa][3], który zabrania skrypt. Zainicjować aplikacji w inny sposób.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows dziwactwa
+
+Wszelkie kontakty wrócił z `pickContact` i `find` metody są tylko do odczytu, więc aplikacja nie mogą ich modyfikować. `find` metody dostępne tylko na urządzenia Windows Phone 8.1.
+
+### Windows 8 dziwactwa
+
+Windows 8 kontaktów są tylko do odczytu. Poprzez kontakty Cordova API są nie queryable/wyszukiwania, należy poinformować użytkownika wybrać kontakt jako wezwanie do contacts.pickContact, która zostanie otwarta aplikacja 'Ludzie', gdzie użytkownik musi wybrać kontakt. Wszelkie kontakty, zwracane są tylko do odczytu, więc aplikacja nie mogą ich modyfikować.
+
+## Navigator.Contacts
+
+### Metody
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Obiekty
+
+*   Kontakt
+*   Przedstawiciel
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## Navigator.Contacts.Create
+
+Metoda `navigator.contacts.create` jest synchroniczna i zwraca nowy obiekt `Contact`.
+
+Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego należy wywołać metodę `Contact.save`.
+
+### Obsługiwane platformy
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+
+### Przykład
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Metoda `navigator.contacts.find` asynchronicznie, wykonuje kwerendy bazy danych kontaktów urządzenia i tablicę obiektów `kontaktów`. Wynikowe obiekty są przekazywane do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr **contactSuccess**.
+
+Parametr **contactFields** Określa pola, które mają być używane jako kwalifikator Szukaj. Zerowej długości **contactFields** parametr jest nieprawidłowy i wyniki w `ContactError.INVALID_ARGUMENT_ERROR`. **ContactFields** wartość `"*"` przeszukuje wszystkie kontakt z pola.
+
+Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy kwerenda bazy danych kontaktów. Jeśli dostarczone, przypadek-niewrażliwe, częściowej wartości mecz jest stosowane do każdego pola określony w parametrze **contactFields**. Jeśli ma odpowiednika dla *każdego* pola określony, zwracany jest kontakt. Użycie **contactFindOptions.desiredFields** parametr do kontroli, które kontakt właściwości muszą zostać zwrócone ponownie.
+
+### Parametry
+
+*   **contactFields**: kontakt z pól do wykorzystania jako kwalifikator Szukaj. *(DOMString[])* [Required]
+
+*   **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z tablicy obiektów kontaktów zwracane z bazy danych. [Required]
+
+*   **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+
+*   **contactFindOptions**: Szukaj opcji filtrowania navigator.contacts. [Optional]
+    
+    Klucze obejmuje:
+    
+    *   **filter**: ciąg wyszukiwania umożliwia znalezienie navigator.contacts. *(DOMString)* (Domyślnie: `""`)
+    
+    *   **multiple**: określa, czy operacja Znajdź zwraca wiele navigator.contacts. *(Wartość logiczna)* (Domyślnie: `false`)
+        
+        *   **desiredFields**: kontakt z pola, aby być zwrócona. Jeśli określony, wynikowy `kontakt` obiekt tylko funkcje wartości tych pól. *(DOMString[])* [Optional]
+
+### Obsługiwane platformy
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+*   Windows (tylko urządzenia Windows Phone 8.1)
+
+### Przykład
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows dziwactwa
+
+*   `__contactFields__`nie jest obsługiwane i zostanie zignorowana. `find`Metoda zawsze będzie próbował dopasować nazwę, adres e-mail lub numer telefonu kontaktu.
+
+## navigator.contacts.pickContact
+
+Metoda `navigator.contacts.pickContact` uruchamia próbnika kontakt, wybierz jeden kontaktem. Wynikowy obiekt jest przekazywany do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr **contactSuccess**.
+
+### Parametry
+
+*   **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z jednego obiektu kontakt. [Wymagane]
+
+*   **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+
+### Obsługiwane platformy
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### Przykład
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Kontakt
+
+`Contact` obiekt reprezentuje informacje kontaktowe. Kontakty mogą być tworzone, przechowywane lub usunięte z bazy danych kontaktów urządzenia. Kontakty można również pobrać (pojedynczo lub zbiorczo) bazy danych przez wywołanie metody `navigator.contacts.find`.
+
+**Uwaga**: nie wszystkie pola kontaktowe wymienione powyżej są obsługiwane na każdej platformie urządzenia. Proszę sprawdzić każdej platformy *dziwactw* sekcji szczegółów.
+
+### Właściwości
+
+*   **Identyfikator**: unikatowy identyfikator globalny. *(DOMString)*
+
+*   **displayName**: Nazwa tego kontaktu, nadaje się do wyświetlania użytkownikom końcowym. *(DOMString)*
+
+*   **Nazwa**: obiekt zawierający wszystkie składniki nazwy osób. *(Przedstawiciel)*
+
+*   **nick**: dorywczo nazwy na adres kontakt. *(DOMString)*
+
+*   **numery telefon≤w**: tablica numerów telefonów kontaktowych. *(ContactField[])*
+
+*   **e-maile**: tablica adresów e-mail kontakt. *(ContactField[])*
+
+*   **adresy**: tablica wszystkie adresy. *(ContactAddress[])*
+
+*   **IMS**: tablica kontakt IM adresy. *(ContactField[])*
+
+*   **organizacje**: tablicy wszystkie kontakty organizacji. *(ContactOrganization[])*
+
+*   **urodziny**: urodziny kontakt. *(Data)*
+
+*   **Uwaga**: Uwaga o kontakt. *(DOMString)*
+
+*   **zdjęcia**: tablica zdjęcia kontaktu. *(ContactField[])*
+
+*   **Kategorie**: tablica wszystkie zdefiniowane przez użytkownika kategorie związane z kontaktem. *(ContactField[])*
+
+*   **adresy URL**: tablicy stron internetowych związanych z kontaktem. *(ContactField[])*
+
+### Metody
+
+*   **klon**: Zwraca nowy `Contact` obiekt, który jest kopią głęboko obiektu wywołującego, z `id` Właściwość zestaw`null`.
+
+*   **Usuń**: usuwa kontakt z bazy danych kontaktów urządzenia, w przeciwnym razie wykonuje błąd wywołania zwrotnego z `ContactError` obiektu.
+
+*   **Zapisz**: zapisuje nowy kontakt do bazy kontaktów urządzenia, lub aktualizacje już istniejący kontakt, jeśli istnieje już kontakt o tym samym **identyfikatorze** .
+
+### Obsługiwane platformy
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+*   Windows 8
+*   Windows
+
+### Zapisz przykład
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Przykład klon
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Remove przykład
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Android 2.X dziwactwa
+
+*   **Kategorie**: nie obsługiwane na urządzeniach Android 2.X, powrót`null`.
+
+### Jeżyna 10 dziwactwa
+
+*   **Identyfikator**: przypisany przez urządzenie podczas zapisywania kontaktu.
+
+### Osobliwości FirefoxOS
+
+*   **Kategorie**: częściowo obsługiwane. Pola **pref** i **Typ** wracają`null`
+
+*   **IMS**: nie obsługiwane
+
+*   **zdjęcia**: nie obsługiwane
+
+### Dziwactwa iOS
+
+*   **displayName**: nie obsługiwane na iOS, powrót `null` chyba jest nie `ContactName` określony, w którym to przypadku zwraca nazwę kompozytowe, **nick** lub `""` , odpowiednio.
+
+*   **urodziny**: należy wpisać jako JavaScript `Date` obiektu, tak samo jest zwracany.
+
+*   **zdjęcia**: zwraca adres URL pliku obrazu, który jest przechowywany w katalogu tymczasowego stosowania. Zawartość katalogu tymczasowe są usuwane, kiedy kończy pracę aplikacji.
+
+*   **Kategorie**: Ta właściwość obecnie jest nie obsługiwane, powrót`null`.
+
+### Windows Phone 7 i 8 dziwactwa
+
+*   **displayName**: podczas tworzenia kontaktu, Źródło wartość podana dla parametru nazwy wyświetlania różni się od nazwy wyświetlanej, gdy znalezienie kontaktu.
+
+*   **adresy URL**: podczas tworzenia kontaktu, użytkownicy mogą wpisać i zapisać więcej niż jeden adres sieci web, ale tylko jeden jest dostępne podczas wyszukiwania kontaktów.
+
+*   **numery telefon≤w**: *pref* opcja nie jest obsługiwana. *Typ* nie jest obsługiwany w operacji *znaleźć* . Jedynym `phoneNumber` jest dozwolone dla każdego *typu*.
+
+*   **e-maile**: *pref* opcja nie jest obsługiwana. Domu i osobiste odwołuje się w tym samym wpisu email. Dla każdego *typu* dozwolone jest tylko jeden wpis.
+
+*   **adresy**: obsługuje tylko pracy i domu/osobisty *typu*. Domowych i osobistych *typu* odwołania tej samej pozycji adres. Dla każdego *typu* dozwolone jest tylko jeden wpis.
+
+*   **organizacje**: tylko jeden jest dozwolone, a nie obsługuje * *pref*, *Typ*i* atrybuty.
+
+*   **Uwaga**: nie obsługiwane, powrót`null`.
+
+*   **IMS**: nie obsługiwane, powrót`null`.
+
+*   **urodziny**: nie obsługiwane, powrót`null`.
+
+*   **Kategorie**: nie obsługiwane, powrót`null`.
+
+### Windows dziwactwa
+
+*   **zdjęcia**: zwraca adres URL pliku obrazu, który jest przechowywany w katalogu tymczasowego stosowania.
+
+*   **urodziny**: nie obsługiwane, powrót`null`.
+
+*   **Kategorie**: nie obsługiwane, powrót`null`.
+
+## ContactAddress
+
+Obiekt `ContactAddress` przechowuje właściwości pojedynczego adresu kontaktu. Obiekt `Contact` może zawierać więcej niż jeden adres w tablicy `[ContactAddress]`.
+
+### Właściwości
+
+*   **Pref**: zestaw `true` Jeśli `ContactAddress` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+*   **Typ**: string wskazującą typ pola, *do domu* na przykład. *(DOMString)*
+
+*   **w formacie**: pełny adres w formacie wyświetlania. *(DOMString)*
+
+*   **adres**: pełny adres. *(DOMString)*
+
+*   **miejscowości**: miasta lub miejscowości. *(DOMString)*
+
+*   **region**: Państwo lub region. *(DOMString)*
+
+*   **Kod pocztowy**: kod pocztowy lub kod pocztowy. *(DOMString)*
+
+*   **kraj**: nazwę kraju. *(DOMString)*
+
+### Obsługiwane platformy
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+*   Windows 8
+*   Windows
+
+### Przykład
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X dziwactwa
+
+*   **Pref**: nie obsługiwane, powrót `false` na urządzeniach Android 2.X.
+
+### Jeżyna 10 dziwactwa
+
+*   **Pref**: nie obsługiwane na urządzenia BlackBerry, powrót`false`.
+
+*   **Typ**: częściowo obsługiwane. Tylko jeden z *pracy* i *Strona główna* wpisz adresy mogą być przechowywane na kontakt.
+
+*   **w formacie**: częściowo obsługiwane. Zwraca łączenie wszystkich pól adres BlackBerry.
+
+*   **adres**: obsługiwane. Zwraca łączenie BlackBerry **address1** i **Adres2** pola adresu.
+
+*   **miejscowości**: obsługiwane. Przechowywane w polu adres **miasto** BlackBerry.
+
+*   **region**: obsługiwane. Przechowywane w polu adres **stateProvince** BlackBerry.
+
+*   **Kod pocztowy**: obsługiwane. Przechowywane w polu adres **zipPostal** BlackBerry.
+
+*   **kraj**: obsługiwane.
+
+### Osobliwości FirefoxOS
+
+*   **w formacie**: aktualnie nieobsługiwane
+
+### Dziwactwa iOS
+
+*   **Pref**: nie obsługiwane urządzenia iOS, powrót`false`.
+
+*   **w formacie**: obecnie nie jest obsługiwane.
+
+### Windows 8 dziwactwa
+
+*   **Pref**: nie obsługiwane
+
+### Windows dziwactwa
+
+*   **Pref**: nie obsługiwane
+
+## ContactError
+
+`ContactError` obiekt jest zwracany użytkownikowi za pośrednictwem funkcji wywołania zwrotnego `contactError`, gdy wystąpi błąd.
+
+### Właściwości
+
+*   **Kod**: jeden z kodów błędów wstępnie zdefiniowanych poniżej.
+
+### Stałe
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Obiekt `ContactField` jest składnikiem wielokrotnego użytku, że reprezentuje kontakt pola ogólnie. Każdy obiekt `ContactField` zawiera `wartość`, `Typ` i `pref` Właściwość. Obiekt `Contact` sklepy kilku właściwości w tablicach `[ContactField]`, takich jak numery telefonów i adresy e-mail.
+
+W większości przypadków są nie wcześniej ustalonych wartości atrybutu **type** obiektu `ContactField`. Na przykład numer telefonu można określić **type** wartości *home*, *work*, *mobile*, *iPhone*, lub jakąkolwiek inną wartość, który jest obsługiwany przez platformę danego urządzenia bazy danych kontaktów. Jednak `Contact` **photos** pola, pole **type** wskazuje format zwrócone obrazu: **url**, gdy **value** atrybut zawiera adres URL, do zdjęć, lub *base64*, gdy **value** zawiera ciąg zakodowany base64 obrazu.
+
+### Właściwości
+
+*   **Typ**: ciąg, który wskazuje typ pola, *do domu* , np. *(DOMString)*
+
+*   **wartości**: wartość pola, na przykład adresu e-mail lub numer telefonu. *(DOMString)*
+
+*   **Pref**: zestaw `true` Jeśli `ContactField` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+### Obsługiwane platformy
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+*   Windows 8
+*   Windows
+
+### Przykład
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Dziwactwa Androida
+
+*   **Pref**: nie obsługiwane, powrót`false`.
+
+### Jeżyna 10 dziwactwa
+
+*   **Typ**: częściowo obsługiwane. Używane numery telefonów.
+
+*   **wartość**: obsługiwane.
+
+*   **Pref**: nie obsługiwane, powrót`false`.
+
+### Dziwactwa iOS
+
+*   **Pref**: nie obsługiwane, powrót`false`.
+
+### Osobliwości Windows8
+
+*   **Pref**: nie obsługiwane, powrót`false`.
+
+### Windows dziwactwa
+
+*   **Pref**: nie obsługiwane, powrót`false`.
+
+## Przedstawiciel
+
+Zawiera różne rodzaje informacji o nazwę obiektu `Contact`.
+
+### Właściwości
+
+*   **w formacie**: pełną nazwę kontaktu. *(DOMString)*
+
+*   **danych**: nazwisko kontaktu. *(DOMString)*
+
+*   **imię**: imię kontaktu. *(DOMString)*
+
+*   **middleName**: nazwy bliskiego kontaktu. *(DOMString)*
+
+*   **honorificPrefix**: kontakt prefiks (przykład *Pan* lub *Dr*) *(DOMString)*
+
+*   **honorificSuffix**: kontakt sufiks (przykład *Esq.*). *(DOMString)*
+
+### Obsługiwane platformy
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+*   Windows 8
+*   Windows
+
+### Przykład
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Dziwactwa Androida
+
+*   **w formacie**: częściowo obsługiwane i tylko do odczytu. Zwraca składa się z `honorificPrefix` , `givenName` , `middleName` , `familyName` , i`honorificSuffix`.
+
+### Jeżyna 10 dziwactwa
+
+*   **w formacie**: częściowo obsługiwane. Zwraca łączenie pól **imię** i **nazwisko** BlackBerry.
+
+*   **danych**: obsługiwane. Przechowywane w BlackBerry pola **nazwisko** .
+
+*   **imię**: obsługiwane. Przechowywane w polu **imię** BlackBerry.
+
+*   **middleName**: nie obsługiwane, powrót`null`.
+
+*   **honorificPrefix**: nie obsługiwane, powrót`null`.
+
+*   **honorificSuffix**: nie obsługiwane, powrót`null`.
+
+### Osobliwości FirefoxOS
+
+*   **w formacie**: częściowo obsługiwane i tylko do odczytu. Zwraca składa się z `honorificPrefix` , `givenName` , `middleName` , `familyName` , i`honorificSuffix`.
+
+### Dziwactwa iOS
+
+*   **w formacie**: częściowo obsługiwane. Zwraca iOS nazwy, ale jest tylko do odczytu.
+
+### Windows 8 dziwactwa
+
+*   **w formacie**: to jest tylko nazwa właściwość i jest taka sama, jak `displayName` , i`nickname`
+
+*   **danych**: nie obsługiwane
+
+*   **imię**: nie obsługiwane
+
+*   **middleName**: nie obsługiwane
+
+*   **honorificPrefix**: nie obsługiwane
+
+*   **honorificSuffix**: nie obsługiwane
+
+### Windows dziwactwa
+
+*   **w formacie**: jest identyczny z`displayName`
+
+## ContactOrganization
+
+Obiekt `ContactOrganization` przechowuje właściwości organizacji kontaktu. Obiekt `Contact` sklepy jeden lub więcej obiektów `ContactOrganization` w tablicy.
+
+### Właściwości
+
+*   **Pref**: zestaw `true` Jeśli `ContactOrganization` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+*   **Typ**: ciąg, który wskazuje typ pola, *do domu* , np. _(DOMString)
+
+*   **Nazwa**: nazwa organizacji. *(DOMString)*
+
+*   **w departamencie**: dziale umowy działa. *(DOMString)*
+
+*   **tytuł**: tytuł kontaktu w organizacji. *(DOMString)*
+
+### Obsługiwane platformy
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 i 8
+*   Windows (tylko urządzenia Windows 8.1 i Windows Phone 8.1)
+
+### Przykład
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X dziwactwa
+
+*   **Pref**: nie obsługiwane przez urządzenia Android 2.X, powrót`false`.
+
+### Jeżyna 10 dziwactwa
+
+*   **Pref**: nie obsługiwane przez urządzenia BlackBerry, powrót`false`.
+
+*   **Typ**: nie obsługiwane przez urządzenia BlackBerry, powrót`null`.
+
+*   **Nazwa**: częściowo obsługiwane. Pierwsza nazwa organizacji są przechowywane w polu **firma** BlackBerry.
+
+*   **w departamencie**: nie obsługiwane, powrót`null`.
+
+*   **tytuł**: częściowo obsługiwane. Pierwszy tytuł organizacji są przechowywane w polu **jobTitle** BlackBerry.
+
+### Firefox OS dziwactwa
+
+*   **Pref**: nie obsługiwane
+
+*   **Typ**: nie obsługiwane
+
+*   **w departamencie**: nie obsługiwane
+
+*   Pola **Nazwa** i **tytuł** przechowywane w **org** i **jobTitle**.
+
+### Dziwactwa iOS
+
+*   **Pref**: nie obsługiwane urządzenia iOS, powrót`false`.
+
+*   **Typ**: nie obsługiwane urządzenia iOS, powrót`null`.
+
+*   **Nazwa**: częściowo obsługiwane. Pierwsza nazwa organizacji są przechowywane w polu **kABPersonOrganizationProperty** iOS.
+
+*   **w departamencie**: częściowo obsługiwane. Pierwsza nazwa jest przechowywana w polu **kABPersonDepartmentProperty** iOS.
+
+*   **tytuł**: częściowo obsługiwane. Pierwszy tytuł jest przechowywany w polu **kABPersonJobTitleProperty** iOS.
+
+### Windows dziwactwa
+
+*   **Pref**: nie obsługiwane, powrót`false`.
+
+*   **Typ**: nie obsługiwane, powrót`null`.

km0App/node_modules/cordova-plugin-contacts/doc/ru/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+Обеспечивает доступ к базе данных контактов устройства.
+
+**Предупреждение**: сбор и использование данные контактов поднимает важные вопросы конфиденциальности. Политика конфиденциальности вашего приложения должна объяснять, как приложение использует контактные данные и передается ли она третьим лицам. Контактная информация считается конфиденциальной, потому что он показывает людей, с которыми общается человек. Таким образом в дополнение к политике конфиденциальности приложения, вы должны рассмотреть возможность предоставления уведомления в момент времени перед тем как приложение обращается к, или использует контактные данные, если операционная системы устройства не делает этого. Это уведомление должно обеспечивать ту же информацию, указанную выше, а также получение разрешения пользователя (например, путем представления выбора **OK** и **Нет, спасибо**). Обратите внимание, что некоторые магазины приложения могут требовать от приложения уведомления в момент доступа к данным и получить разрешение пользователя перед доступом к контактным данным. Четкая и понятная эргономика использования контактных данных помогает избежать недоразумений и ощущаемых злоупотреблений контактными данными. Для получения дополнительной информации пожалуйста, смотрите в руководстве конфиденциальности.
+
+## Установка
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### Особенности Firefox OS
+
+Создайте **www/manifest.webapp** как описано в [Описание Манифеста][1]. Добавление соответствующих разрешений. Существует также необходимость изменить тип веб-приложения на «priviledged» - [Описание Манифеста][2]. **ВНИМАНИЕ**: Все привилегированные приложения применяют [Политику безопасности содержимого][3] которая запрещает встроенные скрипты. Инициализируйте приложение другим способом.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Совместимости Windows
+
+Любые контакты, вернулся из `find` и `pickContact` методы являются только для чтения, поэтому приложение не может изменять их. `find`метод доступен только на устройствах Windows Phone 8.1.
+
+### Совместимости Windows 8
+
+Windows 8 Контакты являются readonly. Через контакты Cordova API не являются queryable/для поиска, вы должны сообщить пользователю выбрать контакт как вызов contacts.pickContact, который откроет приложение «Люди», где пользователь должен выбрать контакт. Любые контакты вернулся, readonly, поэтому ваше приложение не может изменять их.
+
+## navigator.contacts
+
+### Методы
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Объекты
+
+*   Contact
+*   ContactName
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## navigator.contacts.create
+
+Метод `navigator.contacts.create` является синхронным, и возвращает новый объект `Contact`.
+
+Этот метод не сохраняет объект контакта в базе данных контактов устройства, для которого необходимо вызвать метод `Contact.save`.
+
+### Поддерживаемые платформы
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+
+### Пример
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Метод `navigator.contacts.find` выполняется асинхронно, запрашивая базу контактов устройства и возвращая массив объектов `Contact`. Полученные объекты передаются в функцию обратного вызова `contactSuccess`, указанную в параметре **contactSuccess** .
+
+Параметр **contactFields** указывает поля, чтобы использоваться в качестве квалификатора Поиск. Нулевой длины **contactFields** параметр является недопустимым и приводит к `ContactError.INVALID_ARGUMENT_ERROR` . Значение **contactFields** `"*"` возвращает все поля контактов.
+
+Строка **ContactFindOptions.filter** может использоваться как фильтр поиска при запросах к базе данных контактов. Если указано, то к каждому полю, указанному в параметре **contactFields**, применяется фильтр частичного поиска без учета регистра. Если есть совпадение для *любого* из указанных полей, контакт возвращается. Использование параметра **contactFindOptions.desiredFields** для управления свойства контакта должны быть возвращены обратно.
+
+### Параметры
+
+*   **contactSuccess**: Функция обратного вызова вызываемая в случае успешного поиска, с параметром в виде массива объектов Contact возвращенных из базы данных контактов. [Обязательный]
+
+*   **contactError**: Функция обратного вызова, вызывается при возникновении ошибки. [Опционально]
+
+*   **contactFields**: контакт поля для использования в качестве квалификатора Поиск. *(DOMString[])* [Требуется]
+
+*   **contactFindOptions**: Параметры поиска для фильтрации filter navigator.contacts. [Опционально] Ключи включают:
+
+*   **filter**: Строка поиска используемая для поиска по navigator.contacts. *(DOMString)* (по умолчанию: `""`)
+
+*   **multiple**: Определяет если операция поиска возвращает несколкько navigator.contacts. *(Булевое)* (По умолчанию: `false`)
+    
+    *   **desiredFields**: контакт поля возвращается обратно. Если указан, в результате `Contact` объект только функции значения для этих полей. *(DOMString[])* [Опционально]
+
+### Поддерживаемые платформы
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+*   Windows (только для устройств на Windows Phone 8.1)
+
+### Пример
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Совместимости Windows
+
+*   `__contactFields__`не поддерживается и будет игнорироваться. `find`метод всегда будет пытаться соответствовать имя, адрес электронной почты или номер телефона контакта.
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact`Метод запускает контакт выбора, чтобы выбрать один контакт. Результирующий объект передается в `contactSuccess` функции обратного вызова, указанный параметром **contactSuccess** .
+
+### Параметры
+
+*   **contactSuccess**: успех функция обратного вызова вызывается с одним объектом контакта. [Требуется]
+
+*   **contactError**: Функция обратного вызова, вызывается при возникновении ошибки. [Опционально]
+
+### Поддерживаемые платформы
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### Пример
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Contact
+
+Объект `Contact` представляет контакт пользователя. Контакты могут быть созданы, сохранены или удалены из базы данных контактов устройства. Контакты также могут быть получены (индивидуально или массово) из базы данных путем вызова метода `navigator.contacts.find`.
+
+**Примечание**: не все поля контактов, перечисленных выше, поддерживаются на каждой платформе устройства. Пожалуйста, проверьте раздел *Особенности* каждой платформы для детальной информации.
+
+### Параметры
+
+*   **ID**: глобальный уникальный идентификатор. *(DOMString)*
+
+*   **displayName**: имя этого контакта, подходящую для отображения пользователю. *(DOMString)*
+
+*   **name**: объект, содержащий все компоненты имени человека. *(ContactName)*
+
+*   **nickname**: обычное имя, по которому определяется контакт. *(DOMString)*
+
+*   **phoneNumbers**: массив со всеми номерами контактных телефонов. *(ContactField[])*
+
+*   **emails**: массив всех адресов электронной почты контакта. *(ContactField[])*
+
+*   **addresses**: массив всех адресов контакта. *(ContactAddress[])*
+
+*   **IMS**: массив всех IM-адресов контакта. *(ContactField[])*
+
+*   **organizations**: массив всех организаций контакта. *(ContactOrganization[])*
+
+*   **birthday**: день рождения контакта. *(Дата)*
+
+*   **note**: Текстовая заметка о контакте. *(DOMString)*
+
+*   **photos**: массив фотографий контакта. *(ContactField[])*
+
+*   **categories**: массив всех определенных пользователем категории, связанных с контактом. *(ContactField[])*
+
+*   **urls**: массив веб-страниц, связанных с контактом. *(ContactField[])*
+
+### Методы
+
+*   **clone**: возвращает новый объект `Contact`, являющийся глубокой копией вызывающего объекта с значением свойства `id` равным `null`.
+
+*   **remove**: удаляет контакт из базы данных контактов устройства, в противном случае выполняет обратный вызов ошибки с объектом `ContactError` описывающим ошибку.
+
+*   **save**: сохраняет новый контакт в базе данных контактов устройства или обновляет существующий контакт, если контакт с тем же **id** уже существует.
+
+### Поддерживаемые платформы
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+*   Windows 8
+*   Windows
+
+### Пример сохранения
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Пример клонирования
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Пример удаления
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Особенности Android 2.X
+
+*   **categories**: не поддерживается на устройствах Android 2.X, возвращая `null`.
+
+### Особенности BlackBerry 10
+
+*   **ID**: присвоенный устройства при сохранении контакта.
+
+### Особенности Firefox OS
+
+*   **categories**: частично поддерживается. Поля **pref** и **type** возвращают `null`
+
+*   **ims**: Не поддерживается
+
+*   **photos**: Не поддерживается
+
+### Особенности iOS
+
+*   **displayName**: не поддерживается на iOS, возвращая `null` Если `ContactName` не указан, в этом случае он возвращает составное имя, **nickname** или `""` , соответственно.
+
+*   **birthday**: Должен быть указан как объект JavaScript `Date`, таким же образом, значение этого поля и возвращается.
+
+*   **photos**: Возвращает URL-адрес файла изображения, которое хранится во временном каталоге приложения. Содержание временного каталога удаляются при выходе из приложения.
+
+*   **categories**: это свойство в настоящее время не поддерживается, возвращая`null`.
+
+### Особенности Windows Phone 7 и 8
+
+*   **displayName**: при создании контакта, значение, указанное в параметре отличается от отображаемого имени полученного при поиске контакта.
+
+*   **urls**: при создании контакта, пользователи могут ввести и сохранить более чем одного веб-адрес, но только один доступен при поиске контакта.
+
+*   **phoneNumbers**: параметр *pref* не поддерживается. *type* не поддерживается в операции *find* . Только один `phoneNumber` допускается для каждого *type*.
+
+*   **emails**: параметр *pref* не поддерживается. Домашний и рабочий email ссылаются на одну и ту же запись электронной почты. Разрешена только одна запись для каждого значения *type*.
+
+*   **addresses**: поддерживает только рабочий и домашний/личный *type*. Записи типа *type* home и personal ссылаются на одну и ту же запись адреса. Разрешена только одна запись для каждого значения *type*.
+
+*   **organizations**: только одна организация разрешена и она не поддерживает атрибуты *pref*, *type*и *department* .
+
+*   **note**: не поддерживается, возвращая`null`.
+
+*   **ims**: не поддерживается, возвращая `null`.
+
+*   **birthdays**: не поддерживается, возвращая`null`.
+
+*   **categories**: не поддерживается, возвращая`null`.
+
+### Совместимости Windows
+
+*   **фотографии**: Возвращает URL-адрес файла изображения, которое хранится во временном каталоге приложения.
+
+*   **birthdays**: не поддерживается, возвращая`null`.
+
+*   **categories**: не поддерживается, возвращая`null`.
+
+## ContactAddress
+
+Объект `ContactAddress` хранит свойства для одного адреса контакта. Объект `Contact` может включать более чем один адрес в массиве `ContactAddress[]`.
+
+### Параметры
+
+*   **pref**: Установите значение `true` если `ContactAddress` содержит предпочитаемое для пользователя значение. *(логический)*
+
+*   **type**: строка, указывающая тип поля, *home*, например. *(DOMString)*
+
+*   **formatted**: полный адрес отформатированый для отображения. *(DOMString)*
+
+*   **streetAddress**: полный почтовый адрес. *(DOMString)*
+
+*   **locality**: город или населенный пункт. *(DOMString)*
+
+*   **region**: штат или регион. *(DOMString)*
+
+*   **postalCode**: почтовый индекс или почтовый код. *(DOMString)*
+
+*   **country**: название страны. *(DOMString)*
+
+### Поддерживаемые платформы
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+*   Windows 8
+*   Windows
+
+### Пример
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Особенности Android 2.X
+
+*   **ап**: не поддерживается, возвращая `false` на устройствах Android 2.X.
+
+### Особенности BlackBerry 10
+
+*   **ап**: не поддерживается на устройствах BlackBerry, возвращая`false`.
+
+*   **тип**: частично поддерживается. Контакт может храниться только один из *работы* и *дома* типа адреса.
+
+*   **Формат**: частично поддерживается. Возвращает объединение всех полей адреса BlackBerry.
+
+*   **streetAddress**: поддерживается. Возвращает объединение и BlackBerry **Адрес1** **Адрес2** поля адреса.
+
+*   **населенный пункт**: поддерживается. Хранится в поле адрес **город** BlackBerry.
+
+*   **регион**: поддерживает. Хранится в поле адреса **stateProvince** BlackBerry.
+
+*   **postalCode**: поддерживается. Хранится в поле адреса **zipPostal** BlackBerry.
+
+*   **страна**: поддерживается.
+
+### Особенности Firefox OS
+
+*   **formatted**: На данный момент не поддерживается
+
+### Особенности iOS
+
+*   **pref**: не поддерживается на устройствах iOS, возвращая `false`.
+
+*   **formatted**: На данный момент не поддерживается.
+
+### Совместимости Windows 8
+
+*   **pref**: Не поддерживается
+
+### Совместимости Windows
+
+*   **pref**: Не поддерживается
+
+## ContactError
+
+Объект `ContactError` возвращается пользователю через функцию обратного вызова `contactError` в случае возникновении ошибки.
+
+### Параметры
+
+*   **code**: один из стандартных кодов ошибок, перечисленных ниже.
+
+### Константы
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Объект `ContactField` является многократно используемым компонентом, который представляет контактные поля общего назначения. Каждый объект `ContactField` содержит свойства `value` , `type`, и `pref`. Объект `Contact` имеет несколько свойств сохраняющих данные в массиве `ContactField[]`, такие как номера телефонов и адреса электронной почты.
+
+В большинстве случаев не существует заранее определенные значения для атрибута **type** объекта `ContactField`. Например номер телефона можно указать значения **type** *home*, *work*, *mobile*, *iPhone* или любого другого значения, поддерживаемые базы данных контактов на платформе конкретного устройства . Однако, для `Contact` поля **photos**, поле **type** указывает формат возвращаемого изображения: **URL-адрес,** когда атрибут **value** содержит URL-адрес изображения фото или *base64* , если **value** содержит строку изображения в кодировке base64.
+
+### Параметры
+
+*   **type**: строка, указывающая тип поля, *home*, например. *(DOMString)*
+
+*   **value**: значение поля, например номер телефона или адрес электронной почты. *(DOMString)*
+
+*   **pref**: набор `true` Если `ContactField` содержит значение предпочитаемое пользователем. *(логический)*
+
+### Поддерживаемые платформы
+
+*   Amazon Fire OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+*   Windows 8
+*   Windows
+
+### Пример
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Особенности Android
+
+*   **pref**: не поддерживается, возвращая `false`.
+
+### Особенности BlackBerry 10
+
+*   **type**: частично поддерживается. Используется для телефонных номеров.
+
+*   **value**: поддерживается.
+
+*   **pref**: не поддерживается, возвращая `false`.
+
+### Особенности iOS
+
+*   **pref**: не поддерживается, возвращая `false`.
+
+### Причуды Windows8
+
+*   **pref**: не поддерживается, возвращая `false`.
+
+### Совместимости Windows
+
+*   **pref**: не поддерживается, возвращая `false`.
+
+## ContactName
+
+Содержит различную информации об имени объекта `Contact`.
+
+### Параметры
+
+*   **formatted**: полное имя контакта. *(DOMString)*
+
+*   **familyName**: семья имя контакта. *(DOMString)*
+
+*   **givenName**: имя контакта. *(DOMString)*
+
+*   **middleName**: отчество контакта. *(DOMString)*
+
+*   **honorificPrefix**: префикс имени контакта (например, *г-н* или *д-р*) *(DOMString)*
+
+*   **honorificSuffix**: суффикс имени контакта (например, *эсквайр*). *(DOMString)*
+
+### Поддерживаемые платформы
+
+*   Amazon Fire OS
+*   Android 2.X
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+*   Windows 8
+*   Windows
+
+### Пример
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Особенности Android
+
+*   **formatted**: частично поддерживается и только для чтения. Возвращает объединение значений `honorificPrefix`, `givenName`, `middleName`, `familyName`, и `honorificSuffix`.
+
+### Особенности BlackBerry 10
+
+*   **formatted**: частично поддерживается. Возвращает объединение полей BlackBerry **firstName** и **lastName** .
+
+*   **familyName**: поддерживается. Хранится в поле **lastName** BlackBerry.
+
+*   **givenName**: поддерживается. Хранится в поле **firstName** BlackBerry.
+
+*   **middleName**: не поддерживается, возвращая `null`.
+
+*   **honorificPrefix**: не поддерживается, возвращая `null`.
+
+*   **honorificSuffix**: не поддерживается, возвращая `null`.
+
+### Особенности Firefox OS
+
+*   **formatted**: частично поддерживается и только для чтения. Возвращает объединение значений `honorificPrefix`, `givenName`, `middleName`, `familyName`, и `honorificSuffix`.
+
+### Особенности iOS
+
+*   **formatted**: частично поддерживается. Возвращает составное имя iOS, но только для чтения.
+
+### Совместимости Windows 8
+
+*   **Формат**: это единственное имя свойства и идентичен `displayName` , и`nickname`
+
+*   **familyName**: не поддерживается
+
+*   **givenName**: не поддерживается
+
+*   **отчество**: не поддерживается
+
+*   **honorificPrefix**: не поддерживается
+
+*   **honorificSuffix**: не поддерживается
+
+### Совместимости Windows
+
+*   **Формат**: это же`displayName`
+
+## ContactOrganization
+
+Объект `ContactOrganization` сохраняет свойства организации контакта. A объект `Contact` хранит один или больше объектов `ContactOrganization` в массиве.
+
+### Параметры
+
+*   **pref**: Установите в `true` если `ContactOrganization` содержит значение предпочитаемое пользователем. *(логический)*
+
+*   **type**: строка, указывающая тип поля, *home*, например. _(DOMString)
+
+*   **name**: название организации. *(DOMString)*
+
+*   **department**: Отдел в котором работает контакт. *(DOMString)*
+
+*   **title**: должность контакта в организации. *(DOMString)*
+
+### Поддерживаемые платформы
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 и 8
+*   Windows (только Windows 8.1 и 8.1 Windows Phone устройств)
+
+### Пример
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Особенности Android 2.X
+
+*   **pref**: не поддерживается устройствами Android 2.X, возвращая `false`.
+
+### Особенности BlackBerry 10
+
+*   **pref**: не поддерживается на устройствах BlackBerry, возвращая `false`.
+
+*   **type**: не поддерживается на устройствах BlackBerry, возвращая `null`.
+
+*   **name**: частично поддерживается. Первый название организации хранится в поле **company** BlackBerry.
+
+*   **department**: не поддерживается, возвращая `null`.
+
+*   **title**: частично поддерживается. Первый должность в организации хранится в поле **jobTitle** BlackBerry.
+
+### Особенности Firefox OS
+
+*   **pref**: Не поддерживается
+
+*   **type**: Не поддерживается
+
+*   **department**: Не поддерживается
+
+*   Поля **name** и **title** хранятся в полях **org** and **jobTitle**.
+
+### Особенности iOS
+
+*   **pref**: не поддерживается на устройствах iOS, возвращая `false`.
+
+*   **type**: не поддерживается на устройствах iOS, возвращая `null`.
+
+*   **name**: частично поддерживается. Первое название организации хранится в поле **kABPersonOrganizationProperty** iOS.
+
+*   **department**: частично поддерживается. Имя первого отдела хранится в поле **kABPersonDepartmentProperty** iOS.
+
+*   **title**: частично поддерживается. Первая должность хранится в поле **kABPersonJobTitleProperty** iOS.
+
+### Совместимости Windows
+
+*   **pref**: не поддерживается, возвращая `false`.
+
+*   **тип**: не поддерживается, возвращая`null`.

km0App/node_modules/cordova-plugin-contacts/doc/zh/README.md

+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+#         or more contributor license agreements.  See the NOTICE file
+#         distributed with this work for additional information
+#         regarding copyright ownership.  The ASF licenses this file
+#         to you under the Apache License, Version 2.0 (the
+#         "License"); you may not use this file except in compliance
+#         with the License.  You may obtain a copy of the License at
+#
+#           http://www.apache.org/licenses/LICENSE-2.0
+#
+#         Unless required by applicable law or agreed to in writing,
+#         software distributed under the License is distributed on an
+#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#         KIND, either express or implied.  See the License for the
+#         specific language governing permissions and limitations
+#         under the License.
+-->
+
+# cordova-plugin-contacts
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+這個外掛程式定義了一個全域 `navigator.contacts` 物件，提供對設備連絡人資料庫的訪問。
+
+雖然該物件附加到全球範圍內 `導航器`，它不可用直到 `deviceready` 事件之後。
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**警告**： 連絡人資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論應用程式如何使用連絡人資料和它是否被共用與任何其他締約方。 聯繫資訊被認為是敏感，因為它揭示了的人與人溝通了。 因此，除了隱私權原則的應用程式，您應強烈考慮提供時間只是通知之前應用程式訪問或使用連絡人的資料，如果設備作業系統不已經這樣做了。 該通知應提供相同的資訊，如上所述，以及獲取該使用者的許可權 （例如，通過提出選擇 **確定** 並 **不感謝**）。 請注意一些應用程式市場可能需要應用程式提供只是時間的通知，並獲得使用者的許可才能訪問連絡人資料。 周圍的連絡人資料可以説明避免使用者混淆使用和連絡人資料感知的濫用的清楚和容易理解的使用者體驗。 有關詳細資訊，請參閱隱私指南。
+
+## 安裝
+
+這就要求科爾多瓦 5.0 + (當前穩定 v1.0.0)
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+舊版本的科爾多瓦仍可以安裝通過**棄用**id (陳舊 v0.2.16)
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+它也是可以直接通過回購 url 安裝 (不穩定)
+
+    cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+    
+
+### 火狐瀏覽器作業系統的怪癖
+
+在 [清單檔](https://developer.mozilla.org/en-US/Apps/Developing/Manifest) 中所述創建 **www/manifest.webapp**。 添加相關的許可權。 也是需要的 web 應用程式類型更改為"privileged"— — [顯化的文檔](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type)。 **警告**： 所有的特權應用程式強制執行禁止內聯腳本的 [內容的安全性原則](https://developer.mozilla.org/en-US/Apps/CSP)。 在另一種方式初始化您的應用程式。
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows 的怪癖
+
+**之前 Windows 10:**從`發現`和`pickContact`方法返回任何連絡人是唯讀，因此您的應用程式不能修改它們。 僅在 Windows Phone 8.1 設備上可用的 `find` 方法。
+
+**Windows 10 及以上:**連絡人可能保存，並將保存到應用程式本地連絡人存儲。 連絡人也會被刪除。
+
+### Windows 8 的怪癖
+
+Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查詢/搜索，您應通知使用者挑選連絡人作為調用 contacts.pickContact，將會打開 '人' 的應用程式，使用者必須選擇一個連絡人。 返回任何連絡人是唯讀，因此您的應用程式不能修改它們。
+
+## navigator.contacts
+
+### 方法
+
+  * navigator.contacts.create
+  * navigator.contacts.find
+  * navigator.contacts.pickContact
+
+### 物件
+
+  * 連絡人
+  * 連絡人姓名
+  * ContactField
+  * ContactAddress
+  * ContactOrganization
+  * ContactFindOptions
+  * ContactError
+  * ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create` 方法是同步的並返回一個新的 `Contact` 物件。
+
+此方法將不會保留在設備連絡人資料庫中，需要調用 `Contact.save` 方法的聯繫物件。
+
+### 支援的平臺
+
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+
+### 示例
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+`navigator.contacts.find` 方法以非同步方式，執行設備連絡人資料庫查詢並返回 `Contact` 物件的陣列。 生成的物件被傳遞到由 **contactSuccess** 參數指定的 `contactSuccess` 回呼函數。
+
+**contactFields** 參數指定的欄位用作搜索限定詞。 長度為零的 **contactFields** 參數是不正確並導致 `ContactError.INVALID_ARGUMENT_ERROR`。 **contactFields** 值為 `"*"` 搜索所有連絡人欄位。
+
+在連絡人資料庫查詢時，**contactFindOptions.filter** 字串可以用作搜索篩選器。 如果提供，不區分大小寫，部分值匹配被適用于在 **contactFields** 參數中指定的每個欄位。 如果存在匹配的 *任何* 指定的欄位，則返回連絡人。 使用 **contactFindOptions.desiredFields** 參數來控制哪些連絡人屬性必須回來。
+
+### 參數
+
+  * **contactFields**： '連絡人' 欄位用作搜索限定詞。*(DOMString[])* [Required]
+
+  * **contactSuccess**： 從資料庫返回的成功回呼函數調用時使用的連絡人物件的陣列。[Required]
+
+  * **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+
+  * **contactFindOptions**： 搜索選項來篩選 navigator.contacts。[Optional]
+    
+    鍵包括：
+    
+      * **filter**： 用來找到 navigator.contacts 的搜索字串。*() DOMString*（預設： `""`)
+    
+      * **multiple**： 確定是否查找操作返回多個 navigator.contacts。*(布林值)*（預設值： `false`)
+        
+          * **desiredFields**： '連絡人' 欄位，又折回來。如果指定，由此產生的 `Contact` 物件只有這些欄位的功能值。*(DOMString[])* [Optional]
+
+### 支援的平臺
+
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+  * Windows (Windows Phone 8.1 和 Windows 10)
+
+### 示例
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows 的怪癖
+
+  * `__contactFields__`不受支援，將被忽略。`find`方法將始終嘗試匹配名稱、 電子郵件地址或電話號碼的連絡人。
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact` 方法啟動連絡人選取器來選擇一個連絡人。 將生成的物件傳遞給 **contactSuccess** 參數所指定的 `contactSuccess` 回呼函數。
+
+### 參數
+
+  * **contactSuccess**： 成功使用單個連絡人物件調用的回呼函數。[要求]
+
+  * **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+
+### 支援的平臺
+
+  * Android 系統
+  * iOS
+  * Windows Phone 8
+  * Windows 8
+  * Windows
+
+### 示例
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## 連絡人
+
+`Contact` 物件表示使用者的連絡人。 可以創建、 存儲，或從設備的連絡人資料庫中刪除連絡人。 連絡人可以也被 （單獨或批量） 從資料庫中檢索通過調用 `navigator.contacts.find` 方法。
+
+**注**： 並不是所有上面列出的連絡人欄位支援的每個設備的平臺。請檢查每個平臺 *的怪癖* 節瞭解詳細資訊。
+
+### 屬性
+
+  * **id**： 一個全域唯一識別碼。*() DOMString*
+
+  * **displayName**： 此連絡人，適合於向最終使用者顯示的名稱。*() DOMString*
+
+  * **name**： 一個物件，包含所有元件的一個人的名字。*（連絡人姓名）*
+
+  * **nickname**： 休閒的位址連絡人名稱。*() DOMString*
+
+  * **phoneNumbers**： 陣列的所有連絡人的電話號碼。*(ContactField[])*
+
+  * **emails**： 所有連絡人的電子郵件地址的陣列。*(ContactField[])*
+
+  * **addresses**： 該連絡人的所有位址的陣列。*(ContactAddress[])*
+
+  * **ims**： 所有連絡人的 IM 位址的陣列。*(ContactField[])*
+
+  * **organizations**： 該連絡人的所有組織的陣列。*(ContactOrganization[])*
+
+  * **birthday**： 連絡人的生日。*(Date)*
+
+  * **note**： 注意有關的聯繫。*() DOMString*
+
+  * **photos**： 陣列的連絡人的照片。*(ContactField[])*
+
+  * **categories**： 陣列與連絡人關聯的所有使用者定義的類別。*(ContactField[])*
+
+  * **url**： 陣列與連絡人關聯的 web 頁。*(ContactField[])*
+
+### 方法
+
+  * **clone**： 返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.
+
+  * **remove**： 從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。
+
+  * **save**： 將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人，如果已存在具有相同 **id** 的連絡人。
+
+### 支援的平臺
+
+  * 亞馬遜火 OS
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+  * Windows 8
+  * Windows
+
+### 保存示例
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### 克隆示例
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### 刪除示例
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Android 2.X 的怪癖
+
+  * **categories**： 不支援 Android 2.X 在設備上，返回`null`.
+
+### 黑莓 10 怪癖
+
+  * **id**： 由該設備分配時保存該連絡人。
+
+### FirefoxOS 的怪癖
+
+  * **categories**： 部分支援。返回欄位**pref**和**type**`null`
+
+  * **ims**： 不支援
+
+  * **photos**： 不支援
+
+### iOS 的怪癖
+
+  * **displayName**： 上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，**nickname**或 `""` ，分別。
+
+  * **birthday**： 必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。
+
+  * **photos**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。當應用程式退出時刪除臨時目錄的內容。
+
+  * **categories**： 目前不支援此屬性，返回`null`.
+
+### Windows Phone 7 和 8 怪癖
+
+  * **displayName**： 當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。
+
+  * **url**： 當創建一個連絡人，使用者可以輸入和保存多個 web 位址，但只有一個是可用的搜索連絡人時。
+
+  * **phoneNumbers**：*pref*選項不受支援。 在*type*操作中不是支援的*find*。 只有一個 `phoneNumber` 允許的每個*type*.
+
+  * **emails**：*pref*選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項是允許的每個*type*.
+
+  * **addresses**： 僅支援的工作和家庭/個人*type*。家庭和個人*type*引用相同的位址條目。只有一項是允許的每個*type*.
+
+  * **organizations**： 唯一一個允許的和不支援的*pref*、*type*和*department*的屬性。
+
+  * **note**： 不支援，返回`null`.
+
+  * **ims**： 不受支援，返回`null`.
+
+  * **birthdays**: 不受支援，返回`null`.
+
+  * **categories**： 不受支援，返回`null`.
+
+  * **remove**: 不支援方法
+
+### Windows 的怪癖
+
+  * **photos**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。
+
+  * **birthdays**: 不受支援，返回`null`.
+
+  * **categories**： 不受支援，返回`null`.
+
+  * **remove**: 方法只支援 Windows 10 或以上。
+
+## ContactAddress
+
+`ContactAddress` 物件存儲單個位址的連絡人的屬性。 `Contact` 物件可能包括多個位址 `ContactAddress []` 陣列中。
+
+### 屬性
+
+  * **pref**： 設置為 `true` 如果這個 `ContactAddress` 包含使用者的首選的價值。*（Boolean）*
+
+  * **type**： 一個字串，例如指示哪種類型的欄位，這是*home*。*() DOMString*
+
+  * **formatted**： 顯示格式的完整位址。*() DOMString*
+
+  * **streetAddress**： 完整的街道位址。*() DOMString*
+
+  * **locality**： 城市或地點。*() DOMString*
+
+  * **region**： 國家或地區。*() DOMString*
+
+  * **postalCode**： 郵遞區號。*() DOMString*
+
+  * **country**： 國家名稱。*() DOMString*
+
+### 支援的平臺
+
+  * 亞馬遜火 OS
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+  * Windows 8
+  * Windows
+
+### 示例
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X 的怪癖
+
+  * **pref**: 不受支援，返回 `false` Android 2.X 的設備上。
+
+### 黑莓 10 怪癖
+
+  * **pref**： 在返回的黑莓設備上不支援`false`.
+
+  * **type**： 部分支援。只有一個*Word*和*Home*類型位址可以存儲每個連絡人。
+
+  * **formatted**： 部分支援。返回的串聯的所有黑莓手機位址欄位。
+
+  * **streetAddress**： 支援。返回和串聯組成的黑莓**address1** **address2**位址欄位。
+
+  * **locality**： 支援。黑莓手機**city**位址欄位中存儲。
+
+  * **region**： 支援。黑莓**stateProvince**位址欄位中存儲。
+
+  * **postalCode**： 支援。黑莓**zipPostal**位址欄位中存儲。
+
+  * **country**： 支援。
+
+### FirefoxOS 的怪癖
+
+  * **formatted**： 目前不支援
+
+### iOS 的怪癖
+
+  * **pref**： 不支援在 iOS 設備上，返回`false`.
+
+  * **formatted**： 目前不支援。
+
+### Windows 8 的怪癖
+
+  * **pref**： 不支援
+
+### Windows 的怪癖
+
+  * **pref**： 不支援
+
+## ContactError
+
+當發生錯誤時，通過 `contactError` 回呼函數為使用者情況下會返回的 `ContactError` 物件。
+
+### 屬性
+
+  * **code**： 下面列出的預定義的錯誤代碼之一。
+
+### 常量
+
+  * `ContactError.UNKNOWN_ERROR` (code 0)
+  * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+  * `ContactError.TIMEOUT_ERROR` (code 2)
+  * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+  * `ContactError.IO_ERROR` (code 4)
+  * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+  * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField` 物件是可重用的元件代表一般連絡人欄位。 每個 `ContactField` 物件包含一個 `value`、 `type` 和 `pref` 的屬性。 `Contacat` 物件將幾個屬性存儲在 `ContactField []` 陣列，例如電話號碼和電子郵件地址。
+
+在大多數情況下，沒有預先確定的 `ContactField` 物件的 **type** 屬性值。 例如，一個電話號碼可以指定 **type** 值的 *home*、 *work*、 *mobile*、 *iPhone* 或由一個特定的設備平臺接觸資料庫系統支援的任何其他值。 然而，為 `photos` **照片** 欄位中，**type** 欄位指示返回圖像的格式： 當 **value** 屬性包含一個指向的照片圖像或 *base64* URL 時的 **value** 包含 string base64 編碼的圖像的 **url**。
+
+### 屬性
+
+  * **type**： 一個字串，例如指示哪種類型的欄位，這是*home*。*() DOMString*
+
+  * **value**： 欄位的值，如電話號碼或電子郵件地址。*() DOMString*
+
+  * **pref**： 設置為 `true` 如果這個 `ContactField` 包含使用者的首選的價值。*（布林）*
+
+### 支援的平臺
+
+  * 亞馬遜火 OS
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+  * Windows 8
+  * Windows
+
+### 示例
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Android 的怪癖
+
+  * **pref**: 不受支援，返回`false`.
+
+### 黑莓 10 怪癖
+
+  * **type**： 部分支援。使用的電話號碼。
+
+  * **value**： 支援。
+
+  * **pref**: 不受支援，返回`false`.
+
+### iOS 的怪癖
+
+  * **pref**: 不受支援，返回`false`.
+
+### Windows8 的怪癖
+
+  * **pref**: 不受支援，返回`false`.
+
+### Windows 的怪癖
+
+  * **pref**: 不受支援，返回`false`.
+
+## 連絡人姓名
+
+包含不同種類的 `Contact` 物件名稱有關的資訊。
+
+### 屬性
+
+  * **formatted**： 該連絡人的完整名稱。*() DOMString*
+
+  * **familyName**： 連絡人的姓氏。*() DOMString*
+
+  * **givenName**： 連絡人的名字。*() DOMString*
+
+  * **middleName**： 連絡人的中間名。*() DOMString*
+
+  * **honorificPrefix**： 連絡人的首碼 （例如*先生*或*博士*） *(DOMString)*
+
+  * **honorificSuffix**： 連絡人的尾碼 （例如*某某某*）。*() DOMString*
+
+### 支援的平臺
+
+  * 亞馬遜火 OS
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+  * Windows 8
+  * Windows
+
+### 示例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 的怪癖
+
+  * **formatted**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+
+### 黑莓 10 怪癖
+
+  * **formatted**： 部分支援。返回的串聯的黑莓手機**firstName**和**lastName**欄位。
+
+  * **familyName**： 支援。黑莓**lastName**欄位中存儲。
+
+  * **givenName**： 支援。黑莓**firstName**欄位中存儲。
+
+  * **middleName**: 不受支援，返回`null`.
+
+  * **honorificPrefix**: 不受支援，返回`null`.
+
+  * **honorificSuffix**: 不受支援，返回`null`.
+
+### FirefoxOS 的怪癖
+
+  * **formatted**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+
+### iOS 的怪癖
+
+  * **formatted**： 部分支援。返回 iOS 複合名稱，但為唯讀。
+
+### Windows 8 的怪癖
+
+  * **formatted**： 這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`
+
+  * **familyName**： 不支援
+
+  * **givenName**： 不支援
+
+  * **middleName**： 不支援
+
+  * **honorificPrefix**: 不支援
+
+  * **honorificSuffix**: 不支援
+
+### Windows 的怪癖
+
+  * **formatted**： 它是完全相同`displayName`
+
+## ContactOrganization
+
+`ContactOrganization` 物件存儲連絡人的組織屬性。`Contact` 物件將一個或多個 `ContactOrganization` 物件存儲在一個陣列中。
+
+### 屬性
+
+  * **pref**： 設置為 `true` 如果這個 `ContactOrganization` 包含使用者的首選的價值。*（布林）*
+
+  * **type**： 一個字串，例如指示哪種類型的欄位，這是*回家*。_(DOMString)
+
+  * **name**： 組織的名稱。*() DOMString*
+
+  * **department**： 合同工作為的部門。*() DOMString*
+
+  * **title**： 在組織連絡人的標題。*() DOMString*
+
+### 支援的平臺
+
+  * Android 系統
+  * 黑莓 10
+  * 火狐瀏覽器作業系統
+  * iOS
+  * Windows Phone 7 和 8
+  * Windows （Windows 8.1 和 Windows Phone 8.1 設備）
+
+### 示例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X 的怪癖
+
+  * **pref**： 不支援的 Android 2.X 的設備，返回`false`.
+
+### 黑莓 10 怪癖
+
+  * **pref**： 不支援的黑莓手機，返回`false`.
+
+  * **type**： 不支援的黑莓手機，返回`null`.
+
+  * **name**： 部分支援。第一次組織名稱存儲在黑莓**company**欄位中。
+
+  * **department**: 不受支援，返回`null`.
+
+  * **title**： 部分支援。第一次組織標題存儲在欄位中黑莓**jobTitle**。
+
+### 火狐瀏覽器作業系統的怪癖
+
+  * **pref**： 不支援
+
+  * **type**： 不支援
+
+  * **department**： 不支援
+
+  * 欄位**name**和**title**存儲在**org**和**jobTitle**.
+
+### iOS 的怪癖
+
+  * **pref**： 不支援在 iOS 設備上，返回`false`.
+
+  * **type**： 不支援在 iOS 設備上，返回`null`.
+
+  * **name**： 部分支援。第一次組織名稱存儲在 iOS **kABPersonOrganizationProperty**欄位中。
+
+  * **department**： 部分支援。第一部門名稱存儲在 iOS **kABPersonDepartmentProperty**欄位中。
+
+  * **title**： 部分支援。第一個標題存儲在 iOS **kABPersonJobTitleProperty**欄位中。
+
+### Windows 的怪癖
+
+  * **pref**: 不受支援，返回`false`.
+
+  * **type**： 不受支援，返回`null`.

km0App/node_modules/cordova-plugin-contacts/doc/zh/index.md

+<!---
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+# cordova-plugin-contacts
+
+這個外掛程式定義了一個全域 `navigator.contacts` 物件，提供對設備連絡人資料庫的訪問。
+
+雖然該物件附加到全球範圍內 `導航器`，它不可用直到 `deviceready` 事件之後。
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.contacts);
+    }
+    
+
+**警告**： 連絡人資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論應用程式如何使用連絡人資料和它是否被共用與任何其他締約方。 聯繫資訊被認為是敏感，因為它揭示了的人與人溝通了。 因此，除了隱私權原則的應用程式，您應強烈考慮提供時間只是通知之前應用程式訪問或使用連絡人的資料，如果設備作業系統不已經這樣做了。 該通知應提供相同的資訊，如上所述，以及獲取該使用者的許可權 （例如，通過提出選擇 **確定** 並 **不感謝**）。 請注意一些應用程式市場可能需要應用程式提供只是時間的通知，並獲得使用者的許可才能訪問連絡人資料。 周圍的連絡人資料可以説明避免使用者混淆使用和連絡人資料感知的濫用的清楚和容易理解的使用者體驗。 有關詳細資訊，請參閱隱私指南。
+
+## 安裝
+
+    cordova plugin add cordova-plugin-contacts
+    
+
+### 火狐瀏覽器作業系統的怪癖
+
+在 [清單檔][1] 中所述創建 **www/manifest.webapp**。 添加相關的許可權。 也是需要的 web 應用程式類型更改為"privileged"— — [顯化的文檔][2]。 **警告**： 所有的特權應用程式強制執行禁止內聯腳本的 [內容的安全性原則][3]。 在另一種方式初始化您的應用程式。
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Windows 的怪癖
+
+從 `find` 和 `pickContact` 方法返回任何連絡人是唯讀，因此您的應用程式不能修改它們。 僅在 Windows Phone 8.1 設備上可用的 `find` 方法。
+
+### Windows 8 的怪癖
+
+Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查詢/搜索，您應通知使用者挑選連絡人作為調用 contacts.pickContact，將會打開 '人' 的應用程式，使用者必須選擇一個連絡人。 返回任何連絡人是唯讀，因此您的應用程式不能修改它們。
+
+## navigator.contacts
+
+### 方法
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### 物件
+
+*   連絡人
+*   連絡人姓名
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create` 方法是同步的並返回一個新的 `Contact` 物件。
+
+此方法將不會保留在設備連絡人資料庫中，需要調用 `Contact.save` 方法的聯繫物件。
+
+### 支援的平臺
+
+*   Android 系統
+*   黑莓 10
+*   火狐瀏覽器作業系統
+*   iOS
+*   Windows Phone 7 和 8
+
+### 示例
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+`navigator.contacts.find` 方法以非同步方式，執行設備連絡人資料庫查詢並返回 `Contact` 物件的陣列。 生成的物件被傳遞到由 **contactSuccess** 參數指定的 `contactSuccess` 回呼函數。
+
+**contactFields** 參數指定的欄位用作搜索限定詞。 長度為零的 **contactFields** 參數是不正確並導致 `ContactError.INVALID_ARGUMENT_ERROR`。 **contactFields** 值為 `"*"` 搜索所有連絡人欄位。
+
+在連絡人資料庫查詢時，**contactFindOptions.filter** 字串可以用作搜索篩選器。 如果提供，不區分大小寫，部分值匹配被適用于在 **contactFields** 參數中指定的每個欄位。 如果存在匹配的 *任何* 指定的欄位，則返回連絡人。 使用 **contactFindOptions.desiredFields** 參數來控制哪些連絡人屬性必須回來。
+
+### 參數
+
+*   **contactFields**： '連絡人' 欄位用作搜索限定詞。*(DOMString[])* [Required]
+
+*   **contactSuccess**： 從資料庫返回的成功回呼函數調用時使用的連絡人物件的陣列。[Required]
+
+*   **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+
+*   **contactFindOptions**： 搜索選項來篩選 navigator.contacts。[Optional]
+    
+    鍵包括：
+    
+    *   **filter**： 用來找到 navigator.contacts 的搜索字串。*() DOMString*（預設： `""`)
+    
+    *   **multiple**： 確定是否查找操作返回多個 navigator.contacts。*(布林值)*（預設值： `false`)
+        
+        *   **desiredFields**： '連絡人' 欄位，又折回來。如果指定，由此產生的 `Contact` 物件只有這些欄位的功能值。*(DOMString[])* [Optional]
+
+### 支援的平臺
+
+*   Android 系統
+*   黑莓 10
+*   火狐瀏覽器作業系統
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows （僅適用于 Windows Phone 8.1 設備）
+
+### 示例
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(fields, onSuccess, onError, options);
+    
+
+### Windows 的怪癖
+
+*   `__contactFields__`不受支援，將被忽略。`find`方法將始終嘗試匹配名稱、 電子郵件地址或電話號碼的連絡人。
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact` 方法啟動連絡人選取器來選擇一個連絡人。 將生成的物件傳遞給 **contactSuccess** 參數所指定的 `contactSuccess` 回呼函數。
+
+### 參數
+
+*   **contactSuccess**： 成功使用單個連絡人物件調用的回呼函數。[要求]
+
+*   **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+
+### 支援的平臺
+
+*   安卓系統
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+*   Windows
+
+### 示例
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## 連絡人
+
+`Contact` 物件表示使用者的連絡人。 可以創建、 存儲，或從設備的連絡人資料庫中刪除連絡人。 連絡人可以也被 （單獨或批量） 從資料庫中檢索通過調用 `navigator.contacts.find` 方法。
+
+**注**： 並不是所有上面列出的連絡人欄位支援的每個設備的平臺。請檢查每個平臺 *的怪癖* 節瞭解詳細資訊。
+
+### 屬性
+
+*   **id**： 一個全域唯一識別碼。*() DOMString*
+
+*   **displayName**： 此連絡人，適合於向最終使用者顯示的名稱。*() DOMString*
+
+*   **name**： 一個物件，包含所有元件的一個人的名字。*（連絡人姓名）*
+
+*   **nickname**： 休閒的位址連絡人名稱。*() DOMString*
+
+*   **phoneNumbers**： 陣列的所有連絡人的電話號碼。*(ContactField[])*
+
+*   **emails**： 所有連絡人的電子郵件地址的陣列。*(ContactField[])*
+
+*   **addresses**： 該連絡人的所有位址的陣列。*(ContactAddress[])*
+
+*   **ims**： 所有連絡人的 IM 位址的陣列。*(ContactField[])*
+
+*   **organizations**： 該連絡人的所有組織的陣列。*(ContactOrganization[])*
+
+*   **birthday**： 連絡人的生日。*(Date)*
+
+*   **note**： 注意有關的聯繫。*() DOMString*
+
+*   **photos**： 陣列的連絡人的照片。*(ContactField[])*
+
+*   **categories**： 陣列與連絡人關聯的所有使用者定義的類別。*(ContactField[])*
+
+*   **url**： 陣列與連絡人關聯的 web 頁。*(ContactField[])*
+
+### 方法
+
+*   **clone**： 返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.
+
+*   **remove**： 從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。
+
+*   **save**： 將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人，如果已存在具有相同 **id** 的連絡人。
+
+### 支援的平臺
+
+*   亞馬遜火 OS
+*   安卓系統
+*   黑莓 10
+*   火狐瀏覽器的作業系統
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+*   Windows
+
+### 保存示例
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### 克隆示例
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### 刪除示例
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Android 2.X 的怪癖
+
+*   **categories**： 不支援 Android 2.X 在設備上，返回`null`.
+
+### 黑莓 10 的怪癖
+
+*   **id**： 由該設備分配時保存該連絡人。
+
+### FirefoxOS 的怪癖
+
+*   **categories**： 部分支援。返回欄位**pref**和**type**`null`
+
+*   **ims**： 不支援
+
+*   **photos**： 不支援
+
+### iOS 的怪癖
+
+*   **displayName**： 上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，**nickname**或 `""` ，分別。
+
+*   **birthday**： 必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。
+
+*   **photos**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。當應用程式退出時刪除臨時目錄的內容。
+
+*   **categories**： 目前不支援此屬性，返回`null`.
+
+### Windows Phone 7 和 8 的怪癖
+
+*   **displayName**： 當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。
+
+*   **url**： 當創建一個連絡人，使用者可以輸入和保存多個 web 位址，但只有一個是可用的搜索連絡人時。
+
+*   **phoneNumbers**：*pref*選項不受支援。 在*type*操作中不是支援的*find*。 只有一個 `phoneNumber` 允許的每個*type*.
+
+*   **emails**：*pref*選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項是允許的每個*type*.
+
+*   **addresses**： 僅支援的工作和家庭/個人*type*。家庭和個人*type*引用相同的位址條目。只有一項是允許的每個*type*.
+
+*   **organizations**： 唯一一個允許的和不支援的*pref*、*type*和*department*的屬性。
+
+*   **note**： 不支援，返回`null`.
+
+*   **ims**： 不受支援，返回`null`.
+
+*   **birthdays**: 不受支援，返回`null`.
+
+*   **categories**： 不受支援，返回`null`.
+
+### Windows 的怪癖
+
+*   **photos**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。
+
+*   **birthdays**: 不受支援，返回`null`.
+
+*   **categories**： 不受支援，返回`null`.
+
+## ContactAddress
+
+`ContactAddress` 物件存儲單個位址的連絡人的屬性。 `Contact` 物件可能包括多個位址 `ContactAddress []` 陣列中。
+
+### 屬性
+
+*   **pref**： 設置為 `true` 如果這個 `ContactAddress` 包含使用者的首選的價值。*（Boolean）*
+
+*   **type**： 一個字串，例如指示哪種類型的欄位，這是*home*。*() DOMString*
+
+*   **formatted**： 顯示格式的完整位址。*() DOMString*
+
+*   **streetAddress**： 完整的街道位址。*() DOMString*
+
+*   **locality**： 城市或地點。*() DOMString*
+
+*   **region**： 國家或地區。*() DOMString*
+
+*   **postalCode**： 郵遞區號。*() DOMString*
+
+*   **country**： 國家名稱。*() DOMString*
+
+### 支援的平臺
+
+*   亞馬遜火 OS
+*   安卓系統
+*   黑莓 10
+*   火狐瀏覽器的作業系統
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+*   Windows
+
+### 示例
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X 的怪癖
+
+*   **pref**: 不受支援，返回 `false` Android 2.X 的設備上。
+
+### 黑莓 10 的怪癖
+
+*   **pref**： 在返回的黑莓設備上不支援`false`.
+
+*   **type**： 部分支援。只有一個*Word*和*Home*類型位址可以存儲每個連絡人。
+
+*   **formatted**： 部分支援。返回的串聯的所有黑莓手機位址欄位。
+
+*   **streetAddress**： 支援。返回和串聯組成的黑莓**address1** **address2**位址欄位。
+
+*   **locality**： 支援。黑莓手機**city**位址欄位中存儲。
+
+*   **region**： 支援。黑莓**stateProvince**位址欄位中存儲。
+
+*   **postalCode**： 支援。黑莓**zipPostal**位址欄位中存儲。
+
+*   **country**： 支援。
+
+### FirefoxOS 的怪癖
+
+*   **formatted**： 目前不支援
+
+### iOS 的怪癖
+
+*   **pref**： 不支援在 iOS 設備上，返回`false`.
+
+*   **formatted**： 目前不支援。
+
+### Windows 8 的怪癖
+
+*   **pref**： 不支援
+
+### Windows 的怪癖
+
+*   **pref**： 不支援
+
+## ContactError
+
+當發生錯誤時，通過 `contactError` 回呼函數為使用者情況下會返回的 `ContactError` 物件。
+
+### 屬性
+
+*   **code**： 下面列出的預定義的錯誤代碼之一。
+
+### 常量
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField` 物件是可重用的元件代表一般連絡人欄位。 每個 `ContactField` 物件包含一個 `value`、 `type` 和 `pref` 的屬性。 `Contacat` 物件將幾個屬性存儲在 `ContactField []` 陣列，例如電話號碼和電子郵件地址。
+
+在大多數情況下，沒有預先確定的 `ContactField` 物件的 **type** 屬性值。 例如，一個電話號碼可以指定 **type** 值的 *home*、 *work*、 *mobile*、 *iPhone* 或由一個特定的設備平臺接觸資料庫系統支援的任何其他值。 然而，為 `photos` **照片** 欄位中，**type** 欄位指示返回圖像的格式： 當 **value** 屬性包含一個指向的照片圖像或 *base64* URL 時的 **value** 包含 string base64 編碼的圖像的 **url**。
+
+### 屬性
+
+*   **type**： 一個字串，例如指示哪種類型的欄位，這是*home*。*() DOMString*
+
+*   **value**： 欄位的值，如電話號碼或電子郵件地址。*() DOMString*
+
+*   **pref**： 設置為 `true` 如果這個 `ContactField` 包含使用者的首選的價值。*（布林）*
+
+### 支援的平臺
+
+*   亞馬遜火 OS
+*   安卓系統
+*   黑莓 10
+*   火狐瀏覽器的作業系統
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+*   Windows
+
+### 示例
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Android 的怪癖
+
+*   **pref**: 不受支援，返回`false`.
+
+### 黑莓 10 的怪癖
+
+*   **type**： 部分支援。使用的電話號碼。
+
+*   **value**： 支援。
+
+*   **pref**: 不受支援，返回`false`.
+
+### iOS 的怪癖
+
+*   **pref**: 不受支援，返回`false`.
+
+### Windows8 的怪癖
+
+*   **pref**: 不受支援，返回`false`.
+
+### Windows 的怪癖
+
+*   **pref**: 不受支援，返回`false`.
+
+## ContactName
+
+包含不同種類的 `Contact` 物件名稱有關的資訊。
+
+### 屬性
+
+*   **formatted**： 該連絡人的完整名稱。*() DOMString*
+
+*   **familyName**： 連絡人的姓氏。*() DOMString*
+
+*   **givenName**： 連絡人的名字。*() DOMString*
+
+*   **middleName**： 連絡人的中間名。*() DOMString*
+
+*   **honorificPrefix**： 連絡人的首碼 （例如*先生*或*博士*） *(DOMString)*
+
+*   **honorificSuffix**： 連絡人的尾碼 （例如*某某某*）。*() DOMString*
+
+### 支援的平臺
+
+*   亞馬遜火 OS
+*   Android 系統
+*   黑莓 10
+*   火狐瀏覽器的作業系統
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+*   Windows
+
+### 示例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 的怪癖
+
+*   **formatted**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+
+### 黑莓 10 的怪癖
+
+*   **formatted**： 部分支援。返回的串聯的黑莓手機**firstName**和**lastName**欄位。
+
+*   **familyName**： 支援。黑莓**lastName**欄位中存儲。
+
+*   **givenName**： 支援。黑莓**firstName**欄位中存儲。
+
+*   **middleName**: 不受支援，返回`null`.
+
+*   **honorificPrefix**: 不受支援，返回`null`.
+
+*   **honorificSuffix**: 不受支援，返回`null`.
+
+### FirefoxOS 的怪癖
+
+*   **formatted**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+
+### iOS 的怪癖
+
+*   **formatted**： 部分支援。返回 iOS 複合名稱，但為唯讀。
+
+### Windows 8 的怪癖
+
+*   **formatted**： 這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`
+
+*   **familyName**： 不支援
+
+*   **givenName**： 不支援
+
+*   **middleName**： 不支援
+
+*   **honorificPrefix**: 不支援
+
+*   **honorificSuffix**: 不支援
+
+### Windows 的怪癖
+
+*   **formatted**： 它是完全相同`displayName`
+
+## ContactOrganization
+
+`ContactOrganization` 物件存儲連絡人的組織屬性。`Contact` 物件將一個或多個 `ContactOrganization` 物件存儲在一個陣列中。
+
+### 屬性
+
+*   **pref**： 設置為 `true` 如果這個 `ContactOrganization` 包含使用者的首選的價值。*（布林）*
+
+*   **type**： 一個字串，例如指示哪種類型的欄位，這是*回家*。_(DOMString)
+
+*   **name**： 組織的名稱。*() DOMString*
+
+*   **department**： 合同工作為的部門。*() DOMString*
+
+*   **title**： 在組織連絡人的標題。*() DOMString*
+
+### 支援的平臺
+
+*   安卓系統
+*   黑莓 10
+*   火狐瀏覽器的作業系統
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows （Windows 8.1 和 Windows Phone 8.1 設備）
+
+### 示例
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Android 2.X 的怪癖
+
+*   **pref**： 不支援的 Android 2.X 的設備，返回`false`.
+
+### 黑莓 10 的怪癖
+
+*   **pref**： 不支援的黑莓手機，返回`false`.
+
+*   **type**： 不支援的黑莓手機，返回`null`.
+
+*   **name**： 部分支援。第一次組織名稱存儲在黑莓**company**欄位中。
+
+*   **department**: 不受支援，返回`null`.
+
+*   **title**： 部分支援。第一次組織標題存儲在欄位中黑莓**jobTitle**。
+
+### 火狐瀏覽器作業系統的怪癖
+
+*   **pref**： 不支援
+
+*   **type**： 不支援
+
+*   **department**： 不支援
+
+*   欄位**name**和**title**存儲在**org**和**jobTitle**.
+
+### iOS 的怪癖
+
+*   **pref**： 不支援在 iOS 設備上，返回`false`.
+
+*   **type**： 不支援在 iOS 設備上，返回`null`.
+
+*   **name**： 部分支援。第一次組織名稱存儲在 iOS **kABPersonOrganizationProperty**欄位中。
+
+*   **department**： 部分支援。第一部門名稱存儲在 iOS **kABPersonDepartmentProperty**欄位中。
+
+*   **title**： 部分支援。第一個標題存儲在 iOS **kABPersonJobTitleProperty**欄位中。
+
+### Windows 的怪癖
+
+*   **pref**: 不受支援，返回`false`.
+
+*   **type**： 不受支援，返回`null`.

km0App/node_modules/cordova-plugin-contacts/package.json

+{
+  "_args": [
+    [
+      "cordova-plugin-contacts@3.0.1",
+      "/home/manodg/Documents/kilometro0/km0App"
+    ]
+  ],
+  "_from": "cordova-plugin-contacts@3.0.1",
+  "_id": "cordova-plugin-contacts@3.0.1",
+  "_inCache": true,
+  "_installable": true,
+  "_location": "/cordova-plugin-contacts",
+  "_nodeVersion": "8.9.3",
+  "_npmOperationalInternal": {
+    "host": "s3://npm-registry-packages",
+    "tmp": "tmp/cordova-plugin-contacts-3.0.1.tgz_1513795145012_0.4988263240084052"
+  },
+  "_npmUser": {
+    "email": "stevengill97@gmail.com",
+    "name": "stevegill"
+  },
+  "_npmVersion": "4.6.1",
+  "_phantomChildren": {},
+  "_requested": {
+    "name": "cordova-plugin-contacts",
+    "raw": "cordova-plugin-contacts@3.0.1",
+    "rawSpec": "3.0.1",
+    "scope": null,
+    "spec": "3.0.1",
+    "type": "version"
+  },
+  "_requiredBy": [
+    "/"
+  ],
+  "_resolved": "https://registry.npmjs.org/cordova-plugin-contacts/-/cordova-plugin-contacts-3.0.1.tgz",
+  "_shasum": "37aadabec93c982c04a3dcda0e4f1cfa096a84ab",
+  "_shrinkwrap": null,
+  "_spec": "cordova-plugin-contacts@3.0.1",
+  "_where": "/home/manodg/Documents/kilometro0/km0App",
+  "author": {
+    "name": "Apache Software Foundation"
+  },
+  "bugs": {
+    "url": "https://issues.apache.org/jira/browse/CB"
+  },
+  "cordova": {
+    "id": "cordova-plugin-contacts",
+    "platforms": [
+      "amazon-fireos",
+      "android",
+      "blackberry10",
+      "firefoxos",
+      "ios",
+      "ubuntu",
+      "windows",
+      "windows8",
+      "wp8"
+    ]
+  },
+  "dependencies": {},
+  "deprecated": "This plugin has been deprecated",
+  "description": "Cordova Contacts Plugin",
+  "devDependencies": {
+    "jshint": "^2.6.0"
+  },
+  "directories": {},
+  "dist": {
+    "shasum": "37aadabec93c982c04a3dcda0e4f1cfa096a84ab",
+    "tarball": "https://registry.npmjs.org/cordova-plugin-contacts/-/cordova-plugin-contacts-3.0.1.tgz"
+  },
+  "engines": {
+    "cordovaDependencies": {
+      "3.0.0": {
+        "cordova-android": ">=6.3.0"
+      },
+      "4.0.0": {
+        "cordova": ">100"
+      }
+    }
+  },
+  "homepage": "https://github.com/apache/cordova-plugin-contacts#readme",
+  "keywords": [
+    "contacts",
+    "cordova",
+    "cordova-amazon-fireos",
+    "cordova-android",
+    "cordova-blackberry10",
+    "cordova-firefoxos",
+    "cordova-ios",
+    "cordova-ubuntu",
+    "cordova-windows",
+    "cordova-windows8",
+    "cordova-wp7",
+    "cordova-wp8",
+    "ecosystem:cordova"
+  ],
+  "license": "Apache-2.0",
+  "maintainers": [
+    {
+      "name": "vishalmishra",
+      "email": "vishalmishra0907@gmail.com"
+    },
+    {
+      "name": "bowserj",
+      "email": "bowserj@apache.org"
+    },
+    {
+      "name": "purplecabbage",
+      "email": "purplecabbage@gmail.com"
+    },
+    {
+      "name": "filmaj",
+      "email": "maj.fil@gmail.com"
+    },
+    {
+      "name": "shazron",
+      "email": "shazron@gmail.com"
+    },
+    {
+      "name": "csantanapr",
+      "email": "csantana23@gmail.com"
+    },
+    {
+      "name": "stevegill",
+      "email": "stevengill97@gmail.com"
+    }
+  ],
+  "name": "cordova-plugin-contacts",
+  "optionalDependencies": {},
+  "readme": "ERROR: No README data found!",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/apache/cordova-plugin-contacts.git"
+  },
+  "scripts": {
+    "jshint": "node node_modules/jshint/bin/jshint www && node node_modules/jshint/bin/jshint src && node node_modules/jshint/bin/jshint tests",
+    "test": "npm run jshint"
+  },
+  "types": "./types/index.d.ts",
+  "version": "3.0.1"
+}

km0App/node_modules/cordova-plugin-contacts/plugin.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+    xmlns:rim="http://www.blackberry.com/ns/widgets"
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:m3="http://schemas.microsoft.com/appx/2014/manifest"
+    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
+    id="cordova-plugin-contacts"
+    version="3.0.1">
+
+    <name>Contacts</name>
+    <description>Cordova Contacts Plugin</description>
+    <license>Apache 2.0</license>
+    <keywords>cordova,contacts</keywords>
+    <repo>https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git</repo>
+    <issue>https://issues.apache.org/jira/browse/CB/component/12320652</issue>
+
+    <engines>
+        <engine name="cordova-android" version=">=6.3.0" />
+    </engines>
+
+    <js-module src="www/contacts.js" name="contacts">
+        <clobbers target="navigator.contacts" />
+    </js-module>
+
+    <js-module src="www/Contact.js" name="Contact">
+        <clobbers target="Contact" />
+    </js-module>
+
+    <js-module src="www/convertUtils.js" name="convertUtils">
+    </js-module>
+
+    <js-module src="www/ContactAddress.js" name="ContactAddress">
+        <clobbers target="ContactAddress" />
+    </js-module>
+
+    <js-module src="www/ContactError.js" name="ContactError">
+        <clobbers target="ContactError" />
+    </js-module>
+
+    <js-module src="www/ContactField.js" name="ContactField">
+        <clobbers target="ContactField" />
+    </js-module>
+
+    <js-module src="www/ContactFindOptions.js" name="ContactFindOptions">
+        <clobbers target="ContactFindOptions" />
+    </js-module>
+
+    <js-module src="www/ContactName.js" name="ContactName">
+        <clobbers target="ContactName" />
+    </js-module>
+
+    <js-module src="www/ContactOrganization.js" name="ContactOrganization">
+        <clobbers target="ContactOrganization" />
+    </js-module>
+
+    <js-module src="www/ContactFieldType.js" name="ContactFieldType">
+        <merges target="" />
+    </js-module>
+
+    <!-- android -->
+    <platform name="android">
+        <config-file target="res/xml/config.xml" parent="/*">
+            <feature name="Contacts">
+                <param name="android-package" value="org.apache.cordova.contacts.ContactManager"/>
+            </feature>
+        </config-file>
+
+        <config-file target="AndroidManifest.xml" parent="/*">
+            <uses-permission android:name="android.permission.READ_CONTACTS" />
+            <uses-permission android:name="android.permission.WRITE_CONTACTS" />
+            <uses-permission android:name="android.permission.GET_ACCOUNTS" />
+        </config-file>
+
+        <source-file src="src/android/ContactAccessor.java" target-dir="src/org/apache/cordova/contacts" />
+        <source-file src="src/android/ContactAccessorSdk5.java" target-dir="src/org/apache/cordova/contacts" />
+        <source-file src="src/android/ContactManager.java" target-dir="src/org/apache/cordova/contacts" />
+        <source-file src="src/android/ContactInfoDTO.java" target-dir="src/org/apache/cordova/contacts" />
+    </platform>
+
+    <!-- amazon-fireos -->
+    <platform name="amazon-fireos">
+        <config-file target="res/xml/config.xml" parent="/*">
+            <feature name="Contacts">
+                <param name="android-package" value="org.apache.cordova.contacts.ContactManager"/>
+            </feature>
+        </config-file>
+
+        <config-file target="AndroidManifest.xml" parent="/*">
+            <uses-permission android:name="android.permission.READ_CONTACTS" />
+            <uses-permission android:name="android.permission.WRITE_CONTACTS" />
+            <uses-permission android:name="android.permission.GET_ACCOUNTS" />
+        </config-file>
+
+        <source-file src="src/android/ContactAccessor.java" target-dir="src/org/apache/cordova/contacts" />
+        <source-file src="src/android/ContactAccessorSdk5.java" target-dir="src/org/apache/cordova/contacts" />
+        <source-file src="src/android/ContactManager.java" target-dir="src/org/apache/cordova/contacts" />
+    </platform>
+
+    <!-- ubuntu -->
+    <platform name="ubuntu">
+        <config-file target="config.xml" parent="/*">
+            <feature name="Contacts">
+                <param policy_group="contacts" policy_version="1" />
+            </feature>
+        </config-file>
+        <header-file src="src/ubuntu/contacts.h" />
+        <source-file src="src/ubuntu/contacts.cpp" />
+    </platform>
+
+    <!-- ios -->
+    <platform name="ios">
+        <config-file target="config.xml" parent="/*">
+            <feature name="Contacts">
+                <param name="ios-package" value="CDVContacts"/>
+            </feature>
+        </config-file>
+
+        <js-module src="www/ios/contacts.js" name="contacts-ios">
+            <merges target="navigator.contacts" />
+        </js-module>
+
+        <js-module src="www/ios/Contact.js" name="Contact-iOS">
+            <merges target="Contact" />
+        </js-module>
+
+        <header-file src="src/ios/CDVContacts.h" />
+        <source-file src="src/ios/CDVContacts.m" />
+        <header-file src="src/ios/CDVContact.h" />
+        <source-file src="src/ios/CDVContact.m" />
+
+        <framework src="AddressBook.framework" weak="true" />
+        <framework src="AddressBookUI.framework" weak="true" />
+        <framework src="CoreGraphics.framework" />
+    </platform>
+
+    <!-- Browser -->
+    <platform name="browser">
+        <js-module src="src/browser/ContactsProxy.js" name="ContactsProxy">
+            <merges target="navigator.contacts" />
+        </js-module>
+    </platform>
+
+    <!-- blackberry10 -->
+    <platform name="blackberry10">
+        <config-file target="www/config.xml" parent="/widget">
+            <feature name="Contacts" value="Contacts"/>
+        </config-file>
+        <config-file target="www/config.xml" parent="/widget/rim:permissions">
+            <rim:permit>access_pimdomain_contacts</rim:permit>
+        </config-file>
+        <source-file src="src/blackberry10/index.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactActivity.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactAddress.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/contactConsts.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactError.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactField.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactFindOptions.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactName.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactNews.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactOrganization.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/ContactPhoto.js" target-dir="Contacts"></source-file>
+        <source-file src="src/blackberry10/contactUtils.js" target-dir="Contacts"></source-file>
+        <dependency id="cordova-plugin-bb-contacts" />
+        <dependency id="cordova-plugin-bb-pimlib" />
+    </platform>
+
+
+    <!-- wp8 -->
+    <platform name="wp8">
+        <config-file target="config.xml" parent="/*">
+            <feature name="Contacts">
+                <param name="wp-package" value="Contacts"/>
+            </feature>
+        </config-file>
+
+        <config-file target="Properties/WMAppManifest.xml" parent="/Deployment/App/Capabilities">
+            <Capability Name="ID_CAP_CONTACTS" />
+        </config-file>
+
+        <source-file src="src/wp/Contacts.cs" />
+        <source-file src="src/wp/ContactsHelper.cs" />
+        <source-file src="src/wp/ContactPicker.xaml" />
+        <source-file src="src/wp/ContactPicker.xaml.cs" />
+        <source-file src="src/wp/ContactPickerTask.cs" />
+    </platform>
+
+    <!-- firefoxos -->
+    <platform name="firefoxos">
+        <config-file target="config.xml" parent="/*">
+            <permission name="contacts" access="readwrite" description="Required for accessing address book."
+                        privileged="true"/>
+        </config-file>
+        <js-module src="src/firefoxos/ContactsProxy.js" name="ContactsProxy">
+            <runs />
+        </js-module>
+    </platform>
+
+    <!-- Windows 8 -->
+    <platform name="windows8">
+        <js-module src="src/windows8/ContactProxy.js" name="ContactProxy">
+            <runs />
+        </js-module>
+    </platform>
+
+    <!-- Windows -->
+    <platform name="windows">
+        <js-module src="src/windows/ContactProxy.js" name="ContactProxy">
+            <runs />
+        </js-module>
+        <config-file target="package.phone.appxmanifest" parent="/Package/Capabilities">
+            <m3:Capability Name="contacts" />
+        </config-file>
+        <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions=">=10.0.0">
+            <uap:Capability Name="contacts" />
+        </config-file>
+    </platform>
+
+</plugin>

km0App/node_modules/cordova-plugin-contacts/src/android/ContactAccessor.java

+/*
+ * Copyright (C) 2009 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.cordova.contacts;
+
+import java.util.HashMap;
+
+import android.Manifest;
+import android.content.pm.PackageManager;
+import org.apache.cordova.CordovaInterface;
+import org.apache.cordova.LOG;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+/**
+ * This abstract class defines SDK-independent API for communication with
+ * Contacts Provider. The actual implementation used by the application depends
+ * on the level of API available on the device. If the API level is Cupcake or
+ * Donut, we want to use the {@link ContactAccessorSdk3_4} class. If it is
+ * Eclair or higher, we want to use {@link ContactAccessorSdk5}.
+ */
+public abstract class ContactAccessor {
+
+    protected final String LOG_TAG = "ContactsAccessor";
+    protected CordovaInterface mApp;
+
+    /**
+     * Check to see if the data associated with the key is required to
+     * be populated in the Contact object.
+     * @param key
+     * @param map created by running buildPopulationSet.
+     * @return true if the key data is required
+     */
+    protected boolean isRequired(String key, HashMap<String,Boolean> map) {
+        Boolean retVal = map.get(key);
+        return (retVal == null) ? false : retVal.booleanValue();
+    }
+
+    /**
+     * Create a hash map of what data needs to be populated in the Contact object
+     * @param fields the list of fields to populate
+     * @return the hash map of required data
+     */
+    protected HashMap<String, Boolean> buildPopulationSet(JSONObject options) {
+        HashMap<String, Boolean> map = new HashMap<String, Boolean>();
+
+        String key;
+        try {
+            JSONArray desiredFields = null;
+            if (options!=null && options.has("desiredFields")) {
+                desiredFields = options.getJSONArray("desiredFields");
+            }
+            if (desiredFields == null || desiredFields.length() == 0) {
+                map.put("displayName", true);
+                map.put("name", true);
+                map.put("nickname", true);
+                map.put("phoneNumbers", true);
+                map.put("emails", true);
+                map.put("addresses", true);
+                map.put("ims", true);
+                map.put("organizations", true);
+                map.put("birthday", true);
+                map.put("note", true);
+                map.put("urls", true);
+                map.put("photos", true);
+                map.put("categories", true);
+            } else {
+                for (int i = 0; i < desiredFields.length(); i++) {
+                    key = desiredFields.getString(i);
+                    if (key.startsWith("displayName")) {
+                        map.put("displayName", true);
+                    } else if (key.startsWith("name")) {
+                        map.put("displayName", true);
+                        map.put("name", true);
+                    } else if (key.startsWith("nickname")) {
+                        map.put("nickname", true);
+                    } else if (key.startsWith("phoneNumbers")) {
+                        map.put("phoneNumbers", true);
+                    } else if (key.startsWith("emails")) {
+                        map.put("emails", true);
+                    } else if (key.startsWith("addresses")) {
+                        map.put("addresses", true);
+                    } else if (key.startsWith("ims")) {
+                        map.put("ims", true);
+                    } else if (key.startsWith("organizations")) {
+                        map.put("organizations", true);
+                    } else if (key.startsWith("birthday")) {
+                        map.put("birthday", true);
+                    } else if (key.startsWith("note")) {
+                        map.put("note", true);
+                    } else if (key.startsWith("urls")) {
+                        map.put("urls", true);
+                    } else if (key.startsWith("photos")) {
+                        map.put("photos", true);
+                    } else if (key.startsWith("categories")) {
+                        map.put("categories", true);
+                    }
+                }
+            }
+        } catch (JSONException e) {
+            LOG.e(LOG_TAG, e.getMessage(), e);
+        }
+        return map;
+    }
+
+    /**
+     * Convenience method to get a string from a JSON object.  Saves a
+     * lot of try/catch writing.
+     * If the property is not found in the object null will be returned.
+     *
+     * @param obj contact object to search
+     * @param property to be looked up
+     * @return The value of the property
+     */
+    protected String getJsonString(JSONObject obj, String property) {
+        String value = null;
+        try {
+            if (obj != null) {
+                value = obj.getString(property);
+                if (value.equals("null")) {
+                    LOG.d(LOG_TAG, property + " is string called 'null'");
+                    value = null;
+                }
+            }
+       }
+        catch (JSONException e) {
+            LOG.d(LOG_TAG, "Could not get = " + e.getMessage());
+        }
+        return value;
+    }
+
+    /**
+     * Handles adding a JSON Contact object into the database.
+     * @return TODO
+     */
+    public abstract String save(JSONObject contact);
+
+    /**
+     * Handles searching through SDK-specific contacts API.
+     */
+    public abstract JSONArray search(JSONArray filter, JSONObject options);
+
+    /**
+     * Handles searching through SDK-specific contacts API.
+     * @throws JSONException
+     */
+    public abstract JSONObject getContactById(String id) throws JSONException;
+
+    /**
+     * Handles searching through SDK-specific contacts API.
+     * @param desiredFields fields that will filled. All fields will be filled if null
+     * @throws JSONException
+     */
+    public abstract JSONObject getContactById(String id, JSONArray desiredFields) throws JSONException;
+
+    /**
+     * Handles removing a contact from the database.
+     */
+    public abstract boolean remove(String id);
+
+   /**
+     * A class that represents the where clause to be used in the database query
+     */
+    class WhereOptions {
+        private String where;
+        private String[] whereArgs;
+        public void setWhere(String where) {
+            this.where = where;
+        }
+        public String getWhere() {
+            return where;
+        }
+        public void setWhereArgs(String[] whereArgs) {
+            this.whereArgs = whereArgs;
+        }
+        public String[] getWhereArgs() {
+            return whereArgs;
+        }
+    }
+}

km0App/node_modules/cordova-plugin-contacts/src/android/ContactInfoDTO.java

+/*
+       Licensed to the Apache Software Foundation (ASF) under one
+       or more contributor license agreements.  See the NOTICE file
+       distributed with this work for additional information
+       regarding copyright ownership.  The ASF licenses this file
+       to you under the Apache License, Version 2.0 (the
+       "License"); you may not use this file except in compliance
+       with the License.  You may obtain a copy of the License at
+
+         http://www.apache.org/licenses/LICENSE-2.0
+
+       Unless required by applicable law or agreed to in writing,
+       software distributed under the License is distributed on an
+       "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+       KIND, either express or implied.  See the License for the
+       specific language governing permissions and limitations
+       under the License.
+*/
+
+package org.apache.cordova.contacts;
+
+import java.util.HashMap;
+
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+public class ContactInfoDTO {
+
+ String displayName;
+ JSONObject name;
+ JSONArray organizations;
+ JSONArray addresses;
+ JSONArray phones;
+ JSONArray emails;
+ JSONArray ims;
+ JSONArray websites;
+ JSONArray photos;
+ String note;
+ String nickname;
+ String birthday;
+ HashMap<String, Object> desiredFieldsWithVals;
+
+ public ContactInfoDTO() {
+
+  displayName = "";
+  name = new JSONObject();
+  organizations = new JSONArray();
+  addresses = new JSONArray();
+  phones = new JSONArray();
+  emails = new JSONArray();
+  ims = new JSONArray();
+  websites = new JSONArray();
+  photos = new JSONArray();
+  note = "";
+  nickname = "";
+  desiredFieldsWithVals = new HashMap<String, Object>();
+ }
+
+}

km0App/node_modules/cordova-plugin-contacts/src/android/ContactManager.java

+/*
+       Licensed to the Apache Software Foundation (ASF) under one
+       or more contributor license agreements.  See the NOTICE file
+       distributed with this work for additional information
+       regarding copyright ownership.  The ASF licenses this file
+       to you under the Apache License, Version 2.0 (the
+       "License"); you may not use this file except in compliance
+       with the License.  You may obtain a copy of the License at
+
+         http://www.apache.org/licenses/LICENSE-2.0
+
+       Unless required by applicable law or agreed to in writing,
+       software distributed under the License is distributed on an
+       "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+       KIND, either express or implied.  See the License for the
+       specific language governing permissions and limitations
+       under the License.
+*/
+package org.apache.cordova.contacts;
+
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaActivity;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.LOG;
+import org.apache.cordova.PermissionHelper;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import android.Manifest;
+import android.app.Activity;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.ContactsContract.Contacts;
+import android.provider.ContactsContract.RawContacts;
+
+import java.lang.reflect.Method;
+
+public class ContactManager extends CordovaPlugin {
+
+    private ContactAccessor contactAccessor;
+    private CallbackContext callbackContext;        // The callback context from which we were invoked.
+    private JSONArray executeArgs;
+
+    private static final String LOG_TAG = "Contact Query";
+
+    public static final int UNKNOWN_ERROR = 0;
+    public static final int INVALID_ARGUMENT_ERROR = 1;
+    public static final int TIMEOUT_ERROR = 2;
+    public static final int PENDING_OPERATION_ERROR = 3;
+    public static final int IO_ERROR = 4;
+    public static final int NOT_SUPPORTED_ERROR = 5;
+    public static final int OPERATION_CANCELLED_ERROR = 6;
+    public static final int PERMISSION_DENIED_ERROR = 20;
+    private static final int CONTACT_PICKER_RESULT = 1000;
+    public static String [] permissions;
+
+
+    //Request code for the permissions picker (Pick is async and uses intents)
+    public static final int SEARCH_REQ_CODE = 0;
+    public static final int SAVE_REQ_CODE = 1;
+    public static final int REMOVE_REQ_CODE = 2;
+    public static final int PICK_REQ_CODE = 3;
+
+    public static final String READ = Manifest.permission.READ_CONTACTS;
+    public static final String WRITE = Manifest.permission.WRITE_CONTACTS;
+
+
+    /**
+     * Constructor.
+     */
+    public ContactManager() {
+
+    }
+
+
+    protected void getReadPermission(int requestCode)
+    {
+        PermissionHelper.requestPermission(this, requestCode, READ);
+    }
+
+
+    protected void getWritePermission(int requestCode)
+    {
+        PermissionHelper.requestPermission(this, requestCode, WRITE);
+    }
+
+
+    /**
+     * Executes the request and returns PluginResult.
+     *
+     * @param action            The action to execute.
+     * @param args              JSONArray of arguments for the plugin.
+     * @param callbackContext   The callback context used when calling back into JavaScript.
+     * @return                  True if the action was valid, false otherwise.
+     */
+    public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+
+        this.callbackContext = callbackContext;
+        this.executeArgs = args;
+
+        /**
+         * Check to see if we are on an Android 1.X device.  If we are return an error as we
+         * do not support this as of Cordova 1.0.
+         */
+        if (android.os.Build.VERSION.RELEASE.startsWith("1.")) {
+            callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, ContactManager.NOT_SUPPORTED_ERROR));
+            return true;
+        }
+
+        /**
+         * Only create the contactAccessor after we check the Android version or the program will crash
+         * older phones.
+         */
+        if (this.contactAccessor == null) {
+            this.contactAccessor = new ContactAccessorSdk5(this.cordova);
+        }
+
+        if (action.equals("search")) {
+            if(PermissionHelper.hasPermission(this, READ)) {
+                search(executeArgs);
+            }
+            else
+            {
+                getReadPermission(SEARCH_REQ_CODE);
+            }
+        }
+        else if (action.equals("save")) {
+            if(PermissionHelper.hasPermission(this, WRITE))
+            {
+                save(executeArgs);
+            }
+            else
+            {
+                getWritePermission(SAVE_REQ_CODE);
+            }
+        }
+        else if (action.equals("remove")) {
+            if(PermissionHelper.hasPermission(this, WRITE))
+            {
+                remove(executeArgs);
+            }
+            else
+            {
+                getWritePermission(REMOVE_REQ_CODE);
+            }
+        }
+        else if (action.equals("pickContact")) {
+            if(PermissionHelper.hasPermission(this, READ))
+            {
+                pickContactAsync();
+            }
+            else
+            {
+                getReadPermission(PICK_REQ_CODE);
+            }
+        }
+        else {
+            return false;
+        }
+        return true;
+    }
+
+    private void remove(JSONArray args) throws JSONException {
+        final String contactId = args.getString(0);
+        this.cordova.getThreadPool().execute(new Runnable() {
+            public void run() {
+                if (contactAccessor.remove(contactId)) {
+                    callbackContext.success();
+                } else {
+                    callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, UNKNOWN_ERROR));
+                }
+            }
+        });
+    }
+
+    private void save(JSONArray args) throws JSONException {
+        final JSONObject contact = args.getJSONObject(0);
+        this.cordova.getThreadPool().execute(new Runnable(){
+            public void run() {
+                JSONObject res = null;
+                String id = contactAccessor.save(contact);
+                if (id != null) {
+                    try {
+                        res = contactAccessor.getContactById(id);
+                    } catch (JSONException e) {
+                        LOG.e(LOG_TAG, "JSON fail.", e);
+                    }
+                }
+                if (res != null) {
+                    callbackContext.success(res);
+                } else {
+                    callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, UNKNOWN_ERROR));
+                }
+            }
+        });
+    }
+
+    private void search(JSONArray args) throws JSONException
+    {
+        final JSONArray filter = args.getJSONArray(0);
+        final JSONObject options = args.get(1) == null ? null : args.getJSONObject(1);
+        this.cordova.getThreadPool().execute(new Runnable() {
+            public void run() {
+                JSONArray res = contactAccessor.search(filter, options);
+                callbackContext.success(res);
+            }
+        });
+    }
+
+
+    /**
+     * Launches the Contact Picker to select a single contact.
+     */
+    private void pickContactAsync() {
+        final CordovaPlugin plugin = (CordovaPlugin) this;
+        Runnable worker = new Runnable() {
+            public void run() {
+                Intent contactPickerIntent = new Intent(Intent.ACTION_PICK, Contacts.CONTENT_URI);
+                plugin.cordova.startActivityForResult(plugin, contactPickerIntent, CONTACT_PICKER_RESULT);
+            }
+        };
+        this.cordova.getThreadPool().execute(worker);
+    }
+
+    /**
+     * Called when user picks contact.
+     * @param requestCode       The request code originally supplied to startActivityForResult(),
+     *                          allowing you to identify who this result came from.
+     * @param resultCode        The integer result code returned by the child activity through its setResult().
+     * @param intent            An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+     * @throws JSONException
+     */
+    public void onActivityResult(int requestCode, int resultCode, final Intent intent) {
+        if (requestCode == CONTACT_PICKER_RESULT) {
+            if (resultCode == Activity.RESULT_OK) {
+                String contactId = intent.getData().getLastPathSegment();
+                // to populate contact data we require  Raw Contact ID
+                // so we do look up for contact raw id first
+                Cursor c =  this.cordova.getActivity().getContentResolver().query(RawContacts.CONTENT_URI,
+                            new String[] {RawContacts._ID}, RawContacts.CONTACT_ID + " = " + contactId, null, null);
+                if (!c.moveToFirst()) {
+                    this.callbackContext.error("Error occured while retrieving contact raw id");
+                    return;
+                }
+                String id = c.getString(c.getColumnIndex(RawContacts._ID));
+                c.close();
+
+                try {
+                    JSONObject contact = contactAccessor.getContactById(id);
+                    this.callbackContext.success(contact);
+                    return;
+                } catch (JSONException e) {
+                    LOG.e(LOG_TAG, "JSON fail.", e);
+                }
+            } else if (resultCode == Activity.RESULT_CANCELED) {
+                callbackContext.error(OPERATION_CANCELLED_ERROR);
+                return;
+            }
+
+            this.callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, UNKNOWN_ERROR));
+        }
+    }
+
+    public void onRequestPermissionResult(int requestCode, String[] permissions,
+                                             int[] grantResults) throws JSONException
+    {
+        for(int r:grantResults)
+        {
+            if(r == PackageManager.PERMISSION_DENIED)
+            {
+                this.callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, PERMISSION_DENIED_ERROR));
+                return;
+            }
+        }
+        switch(requestCode)
+        {
+            case SEARCH_REQ_CODE:
+                search(executeArgs);
+                break;
+            case SAVE_REQ_CODE:
+                save(executeArgs);
+                break;
+            case REMOVE_REQ_CODE:
+                remove(executeArgs);
+                break;
+            case PICK_REQ_CODE:
+                pickContactAsync();
+                break;
+        }
+    }
+
+    /**
+     * This plugin launches an external Activity when a contact is picked, so we
+     * need to implement the save/restore API in case the Activity gets killed
+     * by the OS while it's in the background. We don't actually save anything
+     * because picking a contact doesn't take in any arguments.
+     */
+    public void onRestoreStateForActivityResult(Bundle state, CallbackContext callbackContext) {
+        this.callbackContext = callbackContext;
+        this.contactAccessor = new ContactAccessorSdk5(this.cordova);
+    }
+}

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactActivity.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactActivity = function (args) {
+    this.direction = args.direction || null;
+    this.description = args.description || "";
+    this.mimeType = args.mimeType || "";
+    this.timestamp = new Date(parseInt(args.timestamp, 10)) || null;
+};
+
+Object.defineProperty(ContactActivity, "INCOMING", {"value": true});
+Object.defineProperty(ContactActivity, "OUTGOING", {"value": false});
+
+module.exports = ContactActivity;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactAddress.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactAddress = function (properties) {
+    this.type = properties && properties.type ? properties.type : "";
+    this.streetAddress = properties && properties.streetAddress ? properties.streetAddress : "";
+    this.streetOther = properties && properties.streetOther ? properties.streetOther : "";
+    this.locality = properties && properties.locality ? properties.locality : "";
+    this.region = properties && properties.region ? properties.region : "";
+    this.postalCode = properties && properties.postalCode ? properties.postalCode : "";
+    this.country = properties && properties.country ? properties.country : "";
+};
+
+Object.defineProperty(ContactAddress, "HOME", {"value": "home"});
+Object.defineProperty(ContactAddress, "WORK", {"value": "work"});
+Object.defineProperty(ContactAddress, "OTHER", {"value": "other"});
+
+module.exports = ContactAddress;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactError.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactError = function (code, msg) {
+    this.code = code;
+    this.message = msg;
+};
+
+Object.defineProperty(ContactError, "UNKNOWN_ERROR", { "value": 0 });
+Object.defineProperty(ContactError, "INVALID_ARGUMENT_ERROR", { "value": 1 });
+Object.defineProperty(ContactError, "TIMEOUT_ERROR", { "value": 2 });
+Object.defineProperty(ContactError, "PENDING_OPERATION_ERROR", { "value": 3 });
+Object.defineProperty(ContactError, "IO_ERROR", { "value": 4 });
+Object.defineProperty(ContactError, "NOT_SUPPORTED_ERROR", { "value": 5 });
+Object.defineProperty(ContactError, "PERMISSION_DENIED_ERROR", { "value": 20 });
+
+module.exports = ContactError;
+

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactField.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactField = function (type, value) {
+    this.type = type || "";
+    this.value = value || "";
+};
+
+Object.defineProperty(ContactField, "HOME", {"value": "home"});
+Object.defineProperty(ContactField, "WORK", {"value": "work"});
+Object.defineProperty(ContactField, "OTHER", {"value": "other"});
+Object.defineProperty(ContactField, "MOBILE", {"value": "mobile"});
+Object.defineProperty(ContactField, "DIRECT", {"value": "direct"});
+
+module.exports = ContactField;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactFindOptions.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+/**
+ * ContactFindOptions.
+ * @constructor
+ * @param filter search fields
+ * @param sort sort fields and order
+ * @param limit max number of contacts to return
+ * @param favorite if set, only favorite contacts will be returned
+ */
+
+var ContactFindOptions = function (filter, sort, limit, favorite) {
+    this.filter = filter || null;
+    this.sort = sort || null;
+    this.limit = limit || -1; // -1 for returning all results
+    this.favorite = favorite || false;
+    this.includeAccounts = [];
+    this.excludeAccounts = [];
+};
+
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_GIVEN_NAME", { "value": 0 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_FAMILY_NAME", { "value": 1 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_ORGANIZATION_NAME", { "value": 2 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_PHONE", { "value": 3 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_EMAIL", { "value": 4 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_BBMPIN", { "value": 5 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_LINKEDIN", { "value": 6 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_TWITTER", { "value": 7 });
+Object.defineProperty(ContactFindOptions, "SEARCH_FIELD_VIDEO_CHAT", { "value": 8 });
+
+Object.defineProperty(ContactFindOptions, "SORT_FIELD_GIVEN_NAME", { "value": 0 });
+Object.defineProperty(ContactFindOptions, "SORT_FIELD_FAMILY_NAME", { "value": 1 });
+Object.defineProperty(ContactFindOptions, "SORT_FIELD_ORGANIZATION_NAME", { "value": 2 });
+
+module.exports = ContactFindOptions;
+

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactName.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+function toFormattedName(properties) {
+    var formatted = "";
+    if (properties && properties.givenName) {
+        formatted = properties.givenName;
+        if (properties && properties.familyName) {
+            formatted += " " + properties.familyName;
+        }
+    }
+    return formatted;
+}
+
+var ContactName = function (properties) {
+    this.familyName = properties && properties.familyName ? properties.familyName : "";
+    this.givenName = properties && properties.givenName ? properties.givenName : "";
+    this.formatted = toFormattedName(properties);
+    this.middleName = properties && properties.middleName ? properties.middleName : "";
+    this.honorificPrefix = properties && properties.honorificPrefix ? properties.honorificPrefix : "";
+    this.honorificSuffix = properties && properties.honorificSuffix ? properties.honorificSuffix : "";
+    this.phoneticFamilyName = properties && properties.phoneticFamilyName ? properties.phoneticFamilyName : "";
+    this.phoneticGivenName = properties && properties.phoneticGivenName ? properties.phoneticGivenName : "";
+};
+
+module.exports = ContactName;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactNews.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactNews = function (args) {
+    this.title = args.title || "";
+    this.body = args.body || "";
+    this.articleSource = args.articleSource || "";
+    this.companies = args.companies || [];
+    this.publishedAt = new Date(parseInt(args.publishedAt, 10)) || null;
+    this.uri = args.uri || "";
+    this.type = args.type || "";
+};
+
+module.exports = ContactNews;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactOrganization.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactOrganization = function (properties) {
+    this.name = properties && properties.name ? properties.name : "";
+    this.department = properties && properties.department ? properties.department : "";
+    this.title = properties && properties.title ? properties.title : "";
+};
+
+module.exports = ContactOrganization;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/ContactPhoto.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+var ContactPhoto = function (originalFilePath, pref) {
+    this.originalFilePath = originalFilePath || "";
+    this.pref = pref || false;
+    this.largeFilePath = "";
+    this.smallFilePath = "";
+};
+
+module.exports = ContactPhoto;

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/contactConsts.js

+/*
+* Copyright 2012 Research In Motion Limited.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+var ATTRIBUTE_KIND,
+    ATTRIBUTE_SUBKIND,
+    kindAttributeMap = {},
+    subKindAttributeMap = {},
+    _TITLE = 26,
+    _START_DATE = 43,
+    _END_DATE = 44;
+
+function populateKindAttributeMap() {
+    ATTRIBUTE_KIND = {
+        Invalid: 0,
+        Phone: 1,
+        Fax: 2,
+        Pager: 3,
+        Email: 4,
+        Website: 5,
+        Feed: 6,
+        Profile: 7,
+        Family: 8,
+        Person: 9,
+        Date: 10,
+        Group: 11,
+        Name: 12,
+        StockSymbol: 13,
+        Ranking: 14,
+        OrganizationAffiliation: 15,
+        Education: 16,
+        Note: 17,
+        InstantMessaging: 18,
+        VideoChat: 19,
+        ConnectionCount: 20,
+        Hidden: 21,
+        Biography: 22,
+        Sound: 23,
+        Notification: 24,
+        MessageSound: 25,
+        MessageNotification: 26
+    };
+
+    kindAttributeMap[ATTRIBUTE_KIND.Phone] = "phoneNumbers";
+    kindAttributeMap[ATTRIBUTE_KIND.Fax] = "faxNumbers";
+    kindAttributeMap[ATTRIBUTE_KIND.Pager] = "pagerNumber";
+    kindAttributeMap[ATTRIBUTE_KIND.Email] = "emails";
+    kindAttributeMap[ATTRIBUTE_KIND.Website] = "urls";
+    kindAttributeMap[ATTRIBUTE_KIND.Profile] = "socialNetworks";
+    kindAttributeMap[ATTRIBUTE_KIND.OrganizationAffiliation] = "organizations";
+    kindAttributeMap[ATTRIBUTE_KIND.Education] = "education";
+    kindAttributeMap[ATTRIBUTE_KIND.Note] = "note";
+    kindAttributeMap[ATTRIBUTE_KIND.InstantMessaging] = "ims";
+    kindAttributeMap[ATTRIBUTE_KIND.VideoChat] = "videoChat";
+    kindAttributeMap[ATTRIBUTE_KIND.Sound] = "ringtone";
+}
+
+function populateSubKindAttributeMap() {
+    ATTRIBUTE_SUBKIND = {
+        Invalid: 0,
+        Other: 1,
+        Home: 2,
+        Work: 3,
+        PhoneMobile: 4,
+        FaxDirect: 5,
+        Blog: 6,
+        WebsiteResume: 7,
+        WebsitePortfolio: 8,
+        WebsitePersonal: 9,
+        WebsiteCompany: 10,
+        ProfileFacebook: 11,
+        ProfileTwitter: 12,
+        ProfileLinkedIn: 13,
+        ProfileGist: 14,
+        ProfileTungle: 15,
+        FamilySpouse: 16,
+        FamilyChild: 17,
+        FamilyParent: 18,
+        PersonManager: 19,
+        PersonAssistant: 20,
+        DateBirthday: 21,
+        DateAnniversary: 22,
+        GroupDepartment: 23,
+        NameGiven: 24,
+        NameSurname: 25,
+        Title: _TITLE,
+        NameSuffix: 27,
+        NameMiddle: 28,
+        NameNickname: 29,
+        NameAlias: 30,
+        NameDisplayName: 31,
+        NamePhoneticGiven: 32,
+        NamePhoneticSurname: 33,
+        StockSymbolNyse: 34,
+        StockSymbolNasdaq: 35,
+        StockSymbolTse: 36,
+        StockSymbolLse: 37,
+        StockSymbolTsx: 38,
+        RankingKlout: 39,
+        RankingTrstRank: 40,
+        OrganizationAffiliationName: 41,
+        OrganizationAffiliationPhoneticName: 42,
+        OrganizationAffiliationTitle: _TITLE,
+        StartDate: _START_DATE,
+        EndDate: _END_DATE,
+        OrganizationAffiliationDetails: 45,
+        EducationInstitutionName: 46,
+        EducationStartDate: _START_DATE,
+        EducationEndDate: _END_DATE,
+        EducationDegree: 47,
+        EducationConcentration: 48,
+        EducationActivities: 49,
+        EducationNotes: 50,
+        InstantMessagingBbmPin: 51,
+        InstantMessagingAim: 52,
+        InstantMessagingAliwangwang: 53,
+        InstantMessagingGoogleTalk: 54,
+        InstantMessagingSametime: 55,
+        InstantMessagingIcq: 56,
+        InstantMessagingIrc: 57,
+        InstantMessagingJabber: 58,
+        InstantMessagingMsLcs: 59,
+        InstantMessagingMsn: 60,
+        InstantMessagingQq: 61,
+        InstantMessagingSkype: 62,
+        InstantMessagingYahooMessenger: 63,
+        InstantMessagingYahooMessengerJapan: 64,
+        VideoChatBbPlaybook: 65,
+        HiddenLinkedIn: 66,
+        HiddenFacebook: 67,
+        HiddenTwitter: 68,
+        ConnectionCountLinkedIn: 69,
+        ConnectionCountFacebook: 70,
+        ConnectionCountTwitter: 71,
+        HiddenChecksum: 72,
+        HiddenSpeedDial: 73,
+        BiographyFacebook: 74,
+        BiographyTwitter: 75,
+        BiographyLinkedIn: 76,
+        SoundRingtone: 77,
+        SimContactType: 78,
+        EcoID: 79,
+        Personal: 80,
+        StockSymbolAll: 81,
+        NotificationVibration: 82,
+        NotificationLED: 83,
+        MessageNotificationVibration: 84,
+        MessageNotificationLED: 85,
+        MessageNotificationDuringCall: 86,
+        VideoChatPin: 87
+    };
+
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Other] = "other";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Home] = "home";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Work] = "work";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.PhoneMobile] = "mobile";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.FaxDirect] = "direct";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Blog] = "blog";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.WebsiteResume] = "resume";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.WebsitePortfolio] = "portfolio";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.WebsitePersonal] = "personal";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.WebsiteCompany] = "company";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.ProfileFacebook] = "facebook";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.ProfileTwitter] = "twitter";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.ProfileLinkedIn] = "linkedin";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.ProfileGist] = "gist";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.ProfileTungle] = "tungle";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.DateBirthday] = "birthday";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.DateAnniversary] = "anniversary";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NameGiven] = "givenName";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NameSurname] = "familyName";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Title] = "honorificPrefix";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NameSuffix] = "honorificSuffix";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NameMiddle] = "middleName";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NamePhoneticGiven] = "phoneticGivenName";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NamePhoneticSurname] = "phoneticFamilyName";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NameNickname] = "nickname";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.NameDisplayName] = "displayName";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.OrganizationAffiliationName] = "name";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.OrganizationAffiliationDetails] = "department";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Title] = "title";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingBbmPin] = "BbmPin";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingAim] = "Aim";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingAliwangwang] = "Aliwangwang";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingGoogleTalk] = "GoogleTalk";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingSametime] = "Sametime";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingIcq] = "Icq";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingJabber] = "Jabber";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingMsLcs] = "MsLcs";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingSkype] = "Skype";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingYahooMessenger] = "YahooMessenger";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.InstantMessagingYahooMessengerJapan] = "YahooMessegerJapan";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.VideoChatBbPlaybook] = "BbPlaybook";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.SoundRingtone] = "ringtone";
+    subKindAttributeMap[ATTRIBUTE_SUBKIND.Personal] = "personal";
+}
+
+module.exports = {
+    getKindAttributeMap: function () {
+        if (!ATTRIBUTE_KIND) {
+            populateKindAttributeMap();
+        }
+
+        return kindAttributeMap;
+    },
+    getSubKindAttributeMap: function () {
+        if (!ATTRIBUTE_SUBKIND) {
+            populateSubKindAttributeMap();
+        }
+
+        return subKindAttributeMap;
+    }
+};

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/contactUtils.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+/* global ContactPickerOptions */
+
+var self,
+    ContactFindOptions = require("./ContactFindOptions"),
+    ContactError = require("./ContactError"),
+    ContactName = require("./ContactName"),
+    ContactOrganization = require("./ContactOrganization"),
+    ContactAddress = require("./ContactAddress"),
+    ContactField = require("./ContactField"),
+    contactConsts = require("./contactConsts"),
+    ContactPhoto = require("./ContactPhoto"),
+    ContactNews = require("./ContactNews"),
+    ContactActivity = require("./ContactActivity");
+
+function populateFieldArray(contactProps, field, ClassName) {
+    if (contactProps[field]) {
+        var list = [],
+        obj;
+
+        contactProps[field].forEach(function (args) {
+            if (ClassName === ContactField) {
+                list.push(new ClassName(args.type, args.value));
+            } else if (ClassName === ContactPhoto) {
+                obj = new ContactPhoto(args.originalFilePath, args.pref);
+                obj.largeFilePath = args.largeFilePath;
+                obj.smallFilePath = args.smallFilePath;
+                list.push(obj);
+            } else if (ClassName === ContactNews) {
+                obj = new ContactNews(args);
+                list.push(obj);
+            } else if (ClassName === ContactActivity) {
+                obj = new ContactActivity(args);
+                list.push(obj);
+            } else {
+                list.push(new ClassName(args));
+            }
+        });
+        contactProps[field] = list;
+    }
+}
+
+function populateDate(contactProps, field) {
+    if (contactProps[field]) {
+        contactProps[field] = new Date(contactProps[field]);
+    }
+}
+
+function validateFindArguments(findOptions) {
+    var error = false;
+    
+    // findOptions is mandatory
+    if (!findOptions) {
+        error = true;
+    } else {
+        // findOptions.filter is optional
+        if (findOptions.filter) {
+            findOptions.filter.forEach(function (f) {
+                switch (f.fieldName) {
+                case ContactFindOptions.SEARCH_FIELD_GIVEN_NAME:
+                case ContactFindOptions.SEARCH_FIELD_FAMILY_NAME:
+                case ContactFindOptions.SEARCH_FIELD_ORGANIZATION_NAME:
+                case ContactFindOptions.SEARCH_FIELD_PHONE:
+                case ContactFindOptions.SEARCH_FIELD_EMAIL:
+                case ContactFindOptions.SEARCH_FIELD_BBMPIN:
+                case ContactFindOptions.SEARCH_FIELD_LINKEDIN:
+                case ContactFindOptions.SEARCH_FIELD_TWITTER:
+                case ContactFindOptions.SEARCH_FIELD_VIDEO_CHAT:
+                    break;
+                default:
+                    error = true;
+                }
+
+                if (!f.fieldValue) {
+                    error = true;
+                }
+            });
+        } 
+
+        //findOptions.limit is optional
+        if (findOptions.limit) {
+            if (typeof findOptions.limit !== "number") {
+                error = true;
+            } 
+        } 
+
+        //findOptions.favorite is optional
+        if (findOptions.favorite) {
+            if (typeof findOptions.favorite !== "boolean") {
+                error = true;
+            }
+        }
+
+        // findOptions.sort is optional
+        if (!error && findOptions.sort && Array.isArray(findOptions.sort)) {
+            findOptions.sort.forEach(function (s) {
+                switch (s.fieldName) {
+                case ContactFindOptions.SORT_FIELD_GIVEN_NAME:
+                case ContactFindOptions.SORT_FIELD_FAMILY_NAME:
+                case ContactFindOptions.SORT_FIELD_ORGANIZATION_NAME:
+                    break;
+                default:
+                    error = true;
+                }
+
+                if (s.desc === undefined || typeof s.desc !== "boolean") {
+                    error = true;
+                }
+            });
+        }
+
+        if (!error && findOptions.includeAccounts) {
+            if (!Array.isArray(findOptions.includeAccounts)) {
+                error = true;
+            } else {
+                findOptions.includeAccounts.forEach(function (acct) {
+                    if (!error && (!acct.id || window.isNaN(window.parseInt(acct.id, 10)))) {
+                        error = true;
+                    }
+                });
+            }
+        }
+
+        if (!error && findOptions.excludeAccounts) {
+            if (!Array.isArray(findOptions.excludeAccounts)) {
+                error = true;
+            } else {
+                findOptions.excludeAccounts.forEach(function (acct) {
+                    if (!error && (!acct.id || window.isNaN(window.parseInt(acct.id, 10)))) {
+                        error = true;
+                    }
+                });
+            }
+        }
+    }
+    return !error;
+}
+
+function validateContactsPickerFilter(filter) {
+    var isValid = true,
+        availableFields = {};
+
+    if (typeof(filter) === "undefined") {
+        isValid = false;
+    } else {
+        if (filter && Array.isArray(filter)) {
+            availableFields = contactConsts.getKindAttributeMap();
+            filter.forEach(function (e) {
+                isValid = isValid && Object.getOwnPropertyNames(availableFields).reduce(
+                    function (found, key) {
+                        return found || availableFields[key] === e;
+                    }, false);
+            });
+        }
+    }
+
+    return isValid;
+}
+
+function validateContactsPickerOptions(options) {
+    var isValid = false,
+        mode = options.mode;
+
+    if (typeof(options) === "undefined") {
+        isValid = false;
+    } else {
+        isValid = mode === ContactPickerOptions.MODE_SINGLE || mode === ContactPickerOptions.MODE_MULTIPLE || mode === ContactPickerOptions.MODE_ATTRIBUTE;
+
+        // if mode is attribute, fields must be defined
+        if (mode === ContactPickerOptions.MODE_ATTRIBUTE && !validateContactsPickerFilter(options.fields)) {
+            isValid = false;
+        }
+    }
+
+    return isValid;
+}
+
+self = module.exports = {
+    populateContact: function (contact) {
+        if (contact.name) {
+            contact.name = new ContactName(contact.name);
+        }
+
+        populateFieldArray(contact, "addresses", ContactAddress);
+        populateFieldArray(contact, "organizations", ContactOrganization);
+        populateFieldArray(contact, "emails", ContactField);
+        populateFieldArray(contact, "phoneNumbers", ContactField);
+        populateFieldArray(contact, "faxNumbers", ContactField);
+        populateFieldArray(contact, "pagerNumbers", ContactField);
+        populateFieldArray(contact, "ims", ContactField);
+        populateFieldArray(contact, "socialNetworks", ContactField);
+        populateFieldArray(contact, "urls", ContactField);
+        populateFieldArray(contact, "photos", ContactPhoto);
+        populateFieldArray(contact, "news", ContactNews);
+        populateFieldArray(contact, "activities", ContactActivity);
+        // TODO categories
+
+        populateDate(contact, "birthday");
+        populateDate(contact, "anniversary");
+    },
+    invokeErrorCallback: function (errorCallback, code) {
+        if (errorCallback) {
+            errorCallback(new ContactError(code));
+        }
+    },
+    validateFindArguments: validateFindArguments,
+    validateContactsPickerFilter: validateContactsPickerFilter,
+    validateContactsPickerOptions: validateContactsPickerOptions
+};
+

km0App/node_modules/cordova-plugin-contacts/src/blackberry10/index.js

+/*
+ * Copyright 2013 Research In Motion Limited.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/* global PluginResult, JNEXT, escape */
+
+var pimContacts,
+    ContactError = require("./ContactError"),
+    ContactName = require("./ContactName"),
+    ContactFindOptions = require("./ContactFindOptions");
+
+function populateSearchFields(fields) {
+    var i,
+        l,
+        key,
+        searchFieldsObject = {},
+        searchFields = [];
+
+    for (i = 0, l = fields.length; i < l; i++) {
+        if (fields[i] === "*") {
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_GIVEN_NAME] = true;
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_FAMILY_NAME] = true;
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_PHONE] = true;
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_EMAIL] = true;
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_ORGANIZATION_NAME] = true;
+        } else if (fields[i] === "displayName" || fields[i] === "name") {
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_GIVEN_NAME] = true;
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_FAMILY_NAME] = true;
+        } else if (fields[i] === "nickname") {
+            // not supported by Cascades
+        } else if (fields[i] === "phoneNumbers") {
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_PHONE] = true;
+        } else if (fields[i] === "emails") {
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_EMAIL] = true;
+        } else if (fields[i] === "addresses") {
+            // not supported by Cascades
+        } else if (fields[i] === "ims") {
+            // not supported by Cascades
+        } else if (fields[i] === "organizations") {
+            searchFieldsObject[ContactFindOptions.SEARCH_FIELD_ORGANIZATION_NAME] = true;
+        } else if (fields[i] === "birthday") {
+            // not supported by Cascades
+        } else if (fields[i] === "note") {
+            // not supported by Cascades
+        } else if (fields[i] === "photos") {
+            // not supported by Cascades
+        } else if (fields[i] === "categories") {
+            // not supported by Cascades
+        } else if (fields[i] === "urls") {
+            // not supported by Cascades
+        }
+    }
+
+    for (key in searchFieldsObject) {
+        if (searchFieldsObject.hasOwnProperty(key)) {
+            searchFields.push(window.parseInt(key));
+        }
+    }
+
+    return searchFields;
+}
+
+function convertBirthday(birthday) {
+    //Convert date string from native to milliseconds since epoch for cordova-js
+    var birthdayInfo;
+    if (birthday) {
+        birthdayInfo = birthday.split("-");
+        return new Date(birthdayInfo[0], birthdayInfo[1] - 1, birthdayInfo[2]).getTime();
+    } else {
+        return null;
+    }
+}
+
+function processJnextSaveData(result, JnextData) {
+    var data = JnextData;
+
+    if (data._success === true) {
+        data.birthday = convertBirthday(data.birthday);
+        result.callbackOk(data, false);
+    } else {
+        result.callbackError(data.code, false);
+    }
+}
+
+function processJnextRemoveData(result, JnextData) {
+    var data = JnextData;
+
+    if (data._success === true) {
+        result.callbackOk(data);
+    } else {
+        result.callbackError(ContactError.UNKNOWN_ERROR, false);
+    }
+}
+
+function processJnextFindData(eventId, eventHandler, JnextData) {
+    var data = JnextData,
+        i,
+        l,
+        more = false,
+        resultsObject = {};
+
+    if (data.contacts) {
+        for (i = 0, l = data.contacts.length; i < l; i++) {
+            data.contacts[i].birthday = convertBirthday(data.contacts[i].birthday);
+            data.contacts[i].name = new ContactName(data.contacts[i].name);
+        }
+    } else {
+        data.contacts = []; // if JnextData.contacts return null, return an empty array
+    }
+
+    if (data._success === true) {
+        eventHandler.error = false;
+    }
+
+    if (eventHandler.multiple) {
+        // Concatenate results; do not add the same contacts
+        for (i = 0, l = eventHandler.searchResult.length; i < l; i++) {
+            resultsObject[eventHandler.searchResult[i].id] = true;
+        }
+
+        for (i = 0, l = data.contacts.length; i < l; i++) {
+            if (resultsObject[data.contacts[i].id]) {
+                // Already existing
+            } else {
+                eventHandler.searchResult.push(data.contacts[i]);
+            }
+        }
+
+        // check if more search is required
+        eventHandler.searchFieldIndex++;
+        if (eventHandler.searchFieldIndex < eventHandler.searchFields.length) {
+            more = true;
+        }
+    } else {
+        eventHandler.searchResult = data.contacts;
+    }
+
+    if (more) {
+        pimContacts.getInstance().invokeJnextSearch(eventId);
+    } else {
+        if (eventHandler.error) {
+            eventHandler.result.callbackError(data.code, false);
+        } else {
+            eventHandler.result.callbackOk(eventHandler.searchResult, false);
+        }
+    }
+}
+
+module.exports = {
+    search: function (successCb, failCb, args, env) {
+        var cordovaFindOptions = {},
+            result = new PluginResult(args, env),
+            key;
+
+        for (key in args) {
+            if (args.hasOwnProperty(key)) {
+                cordovaFindOptions[key] = JSON.parse(decodeURIComponent(args[key]));
+            }
+        }
+
+        pimContacts.getInstance().find(cordovaFindOptions, result, processJnextFindData);
+        result.noResult(true);
+    },
+    save: function (successCb, failCb, args, env) {
+        var attributes = {},
+            result = new PluginResult(args, env),
+            nativeEmails = [];
+
+        attributes = JSON.parse(decodeURIComponent(args[0]));
+
+        //convert birthday format for our native .so file
+        if (attributes.birthday) {
+            attributes.birthday = new Date(attributes.birthday).toDateString();
+        }
+
+        if (attributes.emails) {
+            attributes.emails.forEach(function (email) {
+                if (email.value) {
+                    if (email.type) {
+                        nativeEmails.push({ "type" : email.type, "value" : email.value });
+                    } else {
+                        nativeEmails.push({ "type" : "home", "value" : email.value });
+                    }
+                }
+            });
+            attributes.emails = nativeEmails;
+        }
+
+        if (attributes.id !== null) {
+            attributes.id = window.parseInt(attributes.id);
+        }
+
+        attributes._eventId = result.callbackId;
+        pimContacts.getInstance().save(attributes, result, processJnextSaveData);
+        result.noResult(true);
+    },
+    remove: function (successCb, failCb, args, env) {
+        var result = new PluginResult(args, env),
+            attributes = {
+                "contactId": window.parseInt(JSON.parse(decodeURIComponent(args[0]))),
+                "_eventId": result.callbackId
+            };
+
+        if (!window.isNaN(attributes.contactId)) {
+            pimContacts.getInstance().remove(attributes, result, processJnextRemoveData);
+            result.noResult(true);
+        } else {
+            result.error(ContactError.UNKNOWN_ERROR);
+            result.noResult(false);
+        }
+    }
+};
+
+///////////////////////////////////////////////////////////////////
+// JavaScript wrapper for JNEXT plugin
+///////////////////////////////////////////////////////////////////
+
+JNEXT.PimContacts = function ()
+{
+    var self = this,
+        hasInstance = false;
+
+    self.find = function (cordovaFindOptions, pluginResult, handler) {
+        //register find eventHandler for when JNEXT onEvent fires
+        self.eventHandlers[cordovaFindOptions.callbackId] = {
+            "result" : pluginResult,
+            "action" : "find",
+            "multiple" : cordovaFindOptions[1].filter ? true : false,
+            "fields" : cordovaFindOptions[0],
+            "searchFilter" : cordovaFindOptions[1].filter,
+            "searchFields" : cordovaFindOptions[1].filter ? populateSearchFields(cordovaFindOptions[0]) : null,
+            "searchFieldIndex" : 0,
+            "searchResult" : [],
+            "handler" : handler,
+            "error" : true
+        };
+
+        self.invokeJnextSearch(cordovaFindOptions.callbackId);
+        return "";
+    };
+
+    self.invokeJnextSearch = function(eventId) {
+        var jnextArgs = {},
+            findHandler = self.eventHandlers[eventId];
+
+        jnextArgs._eventId = eventId;
+        jnextArgs.fields = findHandler.fields;
+        jnextArgs.options = {};
+        jnextArgs.options.filter = [];
+
+        if (findHandler.multiple) {
+            jnextArgs.options.filter.push({
+                "fieldName" : findHandler.searchFields[findHandler.searchFieldIndex],
+                "fieldValue" : findHandler.searchFilter
+            });
+            //findHandler.searchFieldIndex++;
+        }
+
+        JNEXT.invoke(self.m_id, "find " + JSON.stringify(jnextArgs));
+    };
+
+    self.getContact = function (args) {
+        return JSON.parse(JNEXT.invoke(self.m_id, "getContact " + JSON.stringify(args)));
+    };
+
+    self.save = function (args, pluginResult, handler) {
+        //register save eventHandler for when JNEXT onEvent fires
+        self.eventHandlers[args._eventId] = {
+            "result" : pluginResult,
+            "action" : "save",
+            "handler" : handler
+        };
+        JNEXT.invoke(self.m_id, "save " + JSON.stringify(args));
+        return "";
+    };
+
+    self.remove = function (args, pluginResult, handler) {
+        //register remove eventHandler for when JNEXT onEvent fires
+        self.eventHandlers[args._eventId] = {
+            "result" : pluginResult,
+            "action" : "remove",
+            "handler" : handler
+        };
+        JNEXT.invoke(self.m_id, "remove " + JSON.stringify(args));
+        return "";
+    };
+
+    self.getId = function () {
+        return self.m_id;
+    };
+
+    self.getContactAccounts = function () {
+        var value = JNEXT.invoke(self.m_id, "getContactAccounts");
+        return JSON.parse(value);
+    };
+
+    self.init = function () {
+        if (!JNEXT.require("libpimcontacts")) {
+            return false;
+        }
+
+        self.m_id = JNEXT.createObject("libpimcontacts.PimContacts");
+
+        if (self.m_id === "") {
+            return false;
+        }
+
+        JNEXT.registerEvents(self);
+    };
+
+    // Handle data coming back from JNEXT native layer. Each async function registers a handler and a PluginResult object.
+    // When JNEXT fires onEvent we parse the result string  back into JSON and trigger the appropriate handler (eventHandlers map
+    // uses callbackId as key), along with the actual data coming back from the native layer. Each function may have its own way of
+    // processing native data so we do not do any processing here.
+
+    self.onEvent = function (strData) {
+        var arData = strData.split(" "),
+            strEventDesc = arData[0],
+            eventHandler,
+            args = {};
+
+        if (strEventDesc === "result") {
+            args.result = escape(strData.split(" ").slice(2).join(" "));
+            eventHandler = self.eventHandlers[arData[1]];
+            if (eventHandler.action === "save" || eventHandler.action === "remove") {
+                eventHandler.handler(eventHandler.result, JSON.parse(decodeURIComponent(args.result)));
+            } else if (eventHandler.action === "find") {
+                eventHandler.handler(arData[1], eventHandler, JSON.parse(decodeURIComponent(args.result)));
+            }
+        }
+    };
+
+    self.m_id = "";
+    self.eventHandlers = {};
+
+    self.getInstance = function () {
+        if (!hasInstance) {
+            self.init();
+            hasInstance = true;
+        }
+        return self;
+    };
+};
+
+pimContacts = new JNEXT.PimContacts();

km0App/node_modules/cordova-plugin-contacts/src/browser/ContactsProxy.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+function notSupported() {
+    console.log('Contacts is not supported');
+    return false;
+}
+
+module.exports = {
+    create: notSupported,
+    find: notSupported,
+    pickContact: notSupported
+};
+
+require('cordova/exec/proxy').add('Contacts', module.exports);

km0App/node_modules/cordova-plugin-contacts/src/firefoxos/ContactsProxy.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/ 
+
+/* global mozContact */
+
+// Cordova contact definition: 
+// http://cordova.apache.org/docs/en/2.5.0/cordova_contacts_contacts.md.html#Contact
+// FxOS contact definition:
+// https://developer.mozilla.org/en-US/docs/Web/API/mozContact
+
+
+var Contact = require('./Contact');
+var ContactField = require('./ContactField');
+var ContactName = require('./ContactName');
+
+// XXX: a hack to check if id is "empty". Cordova inserts a
+// string "this string is supposed to be a unique identifier that will 
+// never show up on a device" if id is empty
+function _hasId(id) {
+    if (!id || id.indexOf(' ') >= 0) {
+        return false;
+    }
+    return true;
+}
+
+// Extend mozContact prototype to provide update from Cordova
+function updateFromCordova(contact, fromContact) {
+
+    function exportContactFieldArray(contactFieldArray, key) {
+        if (!key) {
+            key = 'value';
+        }
+        var arr = [];
+        for (var i=0; i < contactFieldArray.length; i++) {
+            arr.push(contactFieldArray[i][key]);
+        }
+        return arr;
+    }
+
+    function exportAddress(addresses) {
+        // TODO: check moz address format
+        var arr = [];
+        
+        for (var i=0; i < addresses.length; i++) {
+            var addr = {};
+            for (var key in addresses[i]) {
+                if (key == 'formatted' || key == 'id') {
+                    continue;
+                } else if (key == 'type') {
+                    addr[key] = [addresses[i][key]];
+                } else if (key == 'country') {
+                    addr.countryName = addresses[i][key];
+                } else {
+                    addr[key] = addresses[i][key];
+                }
+            }
+            arr.push(addr);
+        }
+        return arr;
+    }
+
+    function exportContactField(data) {
+        var contactFields = [];
+        for (var i=0; i < data.length; i++) {
+            var item = data[i];
+            if (item.value) {
+                var itemData = {value: item.value};
+                if (item.type) {
+                    itemData.type = [item.type];
+                }
+                if (item.pref) {
+                    itemData.pref = item.pref;
+                }
+                contactFields.push(itemData);
+            }
+        }
+        return contactFields;
+    }
+    // adding simple fields [contactField, eventualMozContactField]
+    var nameFields = [['givenName'], ['familyName'],  
+                      ['honorificPrefix'], ['honorificSuffix'],
+                      ['middleName', 'additionalName']];
+    var baseArrayFields = [['displayName', 'name'], ['nickname']];
+    var baseStringFields = [];
+    var j = 0, field; while(field = nameFields[j++]) { // jshint ignore:line
+      if (fromContact.name[field[0]]) {
+        contact[field[1] || field[0]] = fromContact.name[field[0]].split(' ');
+      }
+    }
+    j = 0; while(field = baseArrayFields[j++]) { // jshint ignore:line
+      if (fromContact[field[0]]) {
+        contact[field[1] || field[0]] = fromContact[field[0]].split(' ');
+      }
+    }
+    j = 0; while(field = baseStringFields[j++]) { // jshint ignore:line
+      if (fromContact[field[0]]) {
+        contact[field[1] || field[0]] = fromContact[field[0]];
+      }
+    }
+    if (fromContact.birthday) {
+      contact.bday = new Date(fromContact.birthday);
+    }
+    if (fromContact.emails) {
+        var emails = exportContactField(fromContact.emails);
+        contact.email = emails;
+    }
+    if (fromContact.categories) {
+        contact.category = exportContactFieldArray(fromContact.categories);
+    }
+    if (fromContact.addresses) {
+        contact.adr = exportAddress(fromContact.addresses);
+    }
+    if (fromContact.phoneNumbers) {
+        contact.tel = exportContactField(fromContact.phoneNumbers);
+    }
+    if (fromContact.organizations) {
+        // XXX: organizations are saved in 2 arrays - org and jobTitle
+        //      depending on the usecase it might generate issues
+        //      where wrong title will be added to an organization
+        contact.org = exportContactFieldArray(fromContact.organizations, 'name');
+        contact.jobTitle = exportContactFieldArray(fromContact.organizations, 'title');
+    }
+    if (fromContact.note) {
+        contact.note = [fromContact.note];
+    }
+}
+
+
+// Extend Cordova Contact prototype to provide update from FFOS contact
+Contact.prototype.updateFromMozilla = function(moz) {
+    function exportContactField(data) {
+        var contactFields = [];
+        for (var i=0; i < data.length; i++) {
+            var item = data[i];
+            var itemData = new ContactField(item.type, item.value, item.pref);
+            contactFields.push(itemData);
+        }
+        return contactFields;
+    }
+
+    function makeContactFieldFromArray(data) {
+        var contactFields = [];
+        for (var i=0; i < data.length; i++) {
+            var itemData = new ContactField(null, data[i]);
+            contactFields.push(itemData);
+        }
+        return contactFields;
+    }
+
+    function exportAddresses(addresses) {
+        // TODO: check moz address format
+        var arr = [];
+        
+        for (var i=0; i < addresses.length; i++) {
+            var addr = {};
+            for (var key in addresses[i]) {
+                if (key == 'countryName') {
+                    addr.country = addresses[i][key];
+                } else if (key == 'type') {
+                    addr[key] = addresses[i][key].join(' ');
+                } else {
+                    addr[key] = addresses[i][key];
+                }
+            }
+            arr.push(addr);
+        }
+        return arr;
+    }
+
+    function createOrganizations(orgs, jobs) {
+        orgs = (orgs) ? orgs : [];
+        jobs = (jobs) ? jobs : [];
+        var max_length = Math.max(orgs.length, jobs.length);
+        var organizations = [];
+        for (var i=0; i < max_length; i++) {
+            organizations.push(new ContactOrganization(
+                  null, null, orgs[i] || null, null, jobs[i] || null));
+        }
+        return organizations;
+    }
+
+    function createFormatted(name) {
+        var fields = ['honorificPrefix', 'givenName', 'middleName', 
+                      'familyName', 'honorificSuffix'];
+        var f = '';
+        for (var i = 0; i < fields.length; i++) {
+            if (name[fields[i]]) {
+                if (f) {
+                    f += ' ';
+                }
+                f += name[fields[i]];
+            }
+        }
+        return f;
+    }
+
+
+    if (moz.id) {
+        this.id = moz.id;
+    }
+    var nameFields = [['givenName'], ['familyName'], 
+                       ['honorificPrefix'], ['honorificSuffix'],
+                       ['additionalName', 'middleName']];
+    var baseArrayFields = [['name', 'displayName'], 'nickname', ['note']];
+    var baseStringFields = [];
+    var name = new ContactName();
+    var j = 0, field; while(field = nameFields[j++]) { // jshint ignore:line
+        if (moz[field[0]]) {
+            name[field[1] || field[0]] = moz[field[0]].join(' ');
+        }
+    }
+    this.name = name;
+    j = 0; while(field = baseArrayFields[j++]) { // jshint ignore:line
+        if (moz[field[0]]) {
+            this[field[1] || field[0]] = moz[field[0]].join(' ');
+        }
+    }
+    j = 0; while(field = baseStringFields[j++]) { // jshint ignore:line
+        if (moz[field[0]]) {
+            this[field[1] || field[0]] = moz[field[0]];
+        }
+    }
+    // emails
+    if (moz.email) {
+        this.emails = exportContactField(moz.email);
+    }
+    // categories
+    if (moz.category) {
+        this.categories = makeContactFieldFromArray(moz.category);
+    }
+
+    // addresses
+    if (moz.adr) {
+        this.addresses = exportAddresses(moz.adr);
+    }
+
+    // phoneNumbers
+    if (moz.tel) {
+        this.phoneNumbers = exportContactField(moz.tel);
+    }
+    // birthday
+    if (moz.bday) {
+      this.birthday = Date.parse(moz.bday);
+    }
+    // organizations
+    if (moz.org || moz.jobTitle) {
+        // XXX: organizations array is created from org and jobTitle
+        this.organizations = createOrganizations(moz.org, moz.jobTitle);
+    }
+    // construct a read-only formatted value
+    this.name.formatted = createFormatted(this.name);
+
+    /*  Find out how to translate these parameters
+        // photo: Blob
+        // url: Array with metadata (?)
+        // impp: exportIM(contact.ims), TODO: find the moz impp definition
+        // anniversary
+        // sex
+        // genderIdentity
+        // key
+    */
+};
+
+
+function createMozillaFromCordova(successCB, errorCB, contact) {
+    var moz;
+    // get contact if exists
+    if (_hasId(contact.id)) {
+      var search = navigator.mozContacts.find({
+        filterBy: ['id'], filterValue: contact.id, filterOp: 'equals'});
+      search.onsuccess = function() {
+        moz = search.result[0];
+        updateFromCordova(moz, contact);
+        successCB(moz);
+      };
+      search.onerror = errorCB;
+      return;
+    }
+
+    // create empty contact
+    moz = new mozContact();
+    // if ('init' in moz) {
+      // 1.2 and below compatibility
+      // moz.init();
+    // }
+    updateFromCordova(moz, contact);
+    successCB(moz);
+}
+
+
+function createCordovaFromMozilla(moz) {
+    var contact = new Contact();
+    contact.updateFromMozilla(moz);
+    return contact;
+}
+
+
+// However API requires the ability to save multiple contacts, it is 
+// used to save only one element array
+function saveContacts(successCB, errorCB, contacts) {
+    // a closure which is holding the right moz contact
+    function makeSaveSuccessCB(moz) {
+        return function(result) {
+            // create contact from FXOS contact (might be different than
+            // the original one due to differences in API)
+            var contact = createCordovaFromMozilla(moz);
+            // call callback
+            successCB(contact);
+        };
+    }
+    var i=0;
+    var contact;
+    /*jshint -W083 */
+    while(contact = contacts[i++]) { // jshint ignore:line
+        createMozillaFromCordova(function(moz) {
+            var request = navigator.mozContacts.save(moz);
+            // success and/or fail will be called every time a contact is saved
+            request.onsuccess = makeSaveSuccessCB(moz);
+            request.onerror = errorCB;
+        }, function() {}, contact);
+    }
+    /*jshint +W083 */
+}
+
+
+// API provides a list of ids to be removed
+function remove(successCB, errorCB, ids) {
+    var i;
+    /*jshint -W083 */
+    for (i = 0; i < ids.length; i++){
+        // throw an error if no id provided
+        if (!_hasId(ids[i])) {
+            console.error('FFOS: Attempt to remove unsaved contact');
+            errorCB(0);
+            return;
+        }
+        // check if provided id actually exists 
+        var search = navigator.mozContacts.find({
+            filterBy: ['id'], filterValue: ids[i], filterOp: 'equals'});
+        search.onsuccess = function() {
+            if (search.result.length === 0) {
+                console.error('FFOS: Attempt to remove a non existing contact');
+                errorCB(0);
+                return;
+            }
+            var moz = search.result[0];
+            var request = navigator.mozContacts.remove(moz);
+            request.onsuccess = successCB;
+            request.onerror = errorCB;
+        };
+        search.onerror = errorCB;
+    }
+    /*jshint +W083 */
+}
+
+
+var mozContactSearchFields = [['name', 'displayName'], ['givenName'], 
+    ['familyName'], ['email'], ['tel'], ['jobTitle'], ['note'], 
+    ['tel', 'phoneNumbers'], ['email', 'emails']]; 
+// Searching by nickname and additionalName is forbidden in  1.3 and below
+// Searching by name is forbidden in 1.2 and below
+
+// finds if a key is allowed and returns FFOS name if different
+function getMozSearchField(key) {
+    if (mozContactSearchFields.indexOf([key]) >= 0) {
+        return key;
+    }
+    for (var i=0; i < mozContactSearchFields.length; i++) {
+        if (mozContactSearchFields[i].length > 1) {
+            if (mozContactSearchFields[i][1] === key) {
+                return mozContactSearchFields[i][0];
+            }
+        }
+    }
+    return false;
+}
+
+
+function _getAll(successCB, errorCB, params) {
+    // [contactField, eventualMozContactField]
+    var getall = navigator.mozContacts.getAll({});
+    var contacts = [];
+
+    getall.onsuccess = function() {
+        if (getall.result) {
+            contacts.push(createCordovaFromMozilla(getall.result));
+            getall.continue();
+        } else {
+            successCB(contacts);
+        }
+    };
+    getall.onerror = errorCB;
+}
+
+
+function search(successCB, errorCB, params) {
+    var options = params[1] || {}; 
+    if (!options.filter) {
+        return _getAll(successCB, errorCB, params);
+    }
+    var filterBy = [];
+    // filter and translate fields
+    for (var i=0; i < params[0].length; i++) {
+        var searchField = params[0][i];
+        var mozField = getMozSearchField(searchField);
+        if (searchField === 'name') {
+            // Cordova uses name for search by all name fields.
+            filterBy.push('givenName');
+            filterBy.push('familyName');
+            continue;
+        } 
+        if (searchField === 'displayName' && 'init' in new mozContact()) {
+            // ``init`` in ``mozContact`` indicates FFOS version 1.2 or below
+            // Searching by name (in moz) is then forbidden
+            console.log('FFOS ContactProxy: Unable to search by displayName on FFOS 1.2');
+            continue;
+        } 
+        if (mozField) {
+            filterBy.push(mozField);
+        } else {
+            console.log('FXOS ContactProxy: inallowed field passed to search filtered out: ' + searchField);
+        }
+    }
+
+    var mozOptions = {filterBy: filterBy, filterOp: 'startsWith'};
+    if (!options.multiple) {
+        mozOptions.filterLimit = 1;
+    }
+    mozOptions.filterValue = options.filter;
+    var request = navigator.mozContacts.find(mozOptions);
+    request.onsuccess = function() {
+        var contacts = [];
+        var mozContacts = request.result;
+        for (var i=0; i < mozContacts.length; i++) {
+            contacts.push(createCordovaFromMozilla(mozContacts[i]));
+        }
+        successCB(contacts);
+    };
+    request.onerror = errorCB;
+}
+
+
+module.exports = {
+    save: saveContacts,
+    remove: remove,
+    search: search
+};    
+    
+require("cordova/exec/proxy").add("Contacts", module.exports);

km0App/node_modules/cordova-plugin-contacts/src/ios/CDVContact.h

+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+
+#import <Foundation/Foundation.h>
+#import <AddressBook/ABAddressBook.h>
+#import <AddressBookUI/AddressBookUI.h>
+
+enum CDVContactError {
+    UNKNOWN_ERROR = 0,
+    INVALID_ARGUMENT_ERROR = 1,
+    TIMEOUT_ERROR = 2,
+    PENDING_OPERATION_ERROR = 3,
+    IO_ERROR = 4,
+    NOT_SUPPORTED_ERROR = 5,
+    OPERATION_CANCELLED_ERROR = 6,
+    PERMISSION_DENIED_ERROR = 20
+};
+typedef NSUInteger CDVContactError;
+
+@interface CDVContact : NSObject {
+    ABRecordRef record;         // the ABRecord associated with this contact
+    NSDictionary* returnFields; // dictionary of fields to return when performing search
+}
+
+@property (nonatomic, assign) ABRecordRef record;
+@property (nonatomic, strong) NSDictionary* returnFields;
+
++ (NSDictionary*)defaultABtoW3C;
++ (NSDictionary*)defaultW3CtoAB;
++ (NSSet*)defaultW3CtoNull;
++ (NSDictionary*)defaultObjectAndProperties;
++ (NSDictionary*)defaultFields;
+
++ (NSDictionary*)calcReturnFields:(NSArray*)fields;
+- (id)init;
+- (id)initFromABRecord:(ABRecordRef)aRecord;
+- (bool)setFromContactDict:(NSDictionary*)aContact asUpdate:(BOOL)bUpdate;
+
++ (BOOL)needsConversion:(NSString*)W3Label;
++ (NSDictionary *) getContactLabels;
++ (NSArray *) filterLabels: (NSString *) contactApiLabel;
++ (CFStringRef)convertContactTypeToPropertyLabel:(NSString*)label;
++ (NSString*)convertPropertyLabelToContactType:(NSString*)label;
++ (BOOL)isValidW3ContactType:(NSString*)label;
+- (bool)setValue:(id)aValue forProperty:(ABPropertyID)aProperty inRecord:(ABRecordRef)aRecord asUpdate:(BOOL)bUpdate;
+
+- (NSDictionary*)toDictionary:(NSDictionary*)withFields;
+- (NSNumber*)getDateAsNumber:(ABPropertyID)datePropId;
+- (NSObject*)extractName;
+- (NSObject*)extractMultiValue:(NSString*)propertyId;
+- (NSObject*)extractAddresses;
+- (NSObject*)extractIms;
+- (NSObject*)extractOrganizations;
+- (NSObject*)extractPhotos;
+
+- (NSMutableDictionary*)translateW3Dict:(NSDictionary*)dict forProperty:(ABPropertyID)prop;
+- (bool)setMultiValueStrings:(NSArray*)fieldArray forProperty:(ABPropertyID)prop inRecord:(ABRecordRef)person asUpdate:(BOOL)bUpdate;
+- (bool)setMultiValueDictionary:(NSArray*)array forProperty:(ABPropertyID)prop inRecord:(ABRecordRef)person asUpdate:(BOOL)bUpdate;
+- (ABMultiValueRef)allocStringMultiValueFromArray:array;
+- (ABMultiValueRef)allocDictMultiValueFromArray:array forProperty:(ABPropertyID)prop;
+- (BOOL)foundValue:(NSString*)testValue inFields:(NSDictionary*)searchFields;
+- (BOOL)testStringValue:(NSString*)testValue forW3CProperty:(NSString*)property;
+- (BOOL)testDateValue:(NSString*)testValue forW3CProperty:(NSString*)property;
+- (BOOL)searchContactFields:(NSArray*)fields forMVStringProperty:(ABPropertyID)propId withValue:testValue;
+- (BOOL)testMultiValueStrings:(NSString*)testValue forProperty:(ABPropertyID)propId ofType:(NSString*)type;
+- (NSArray*)valuesForProperty:(ABPropertyID)propId inRecord:(ABRecordRef)aRecord;
+- (NSArray*)labelsForProperty:(ABPropertyID)propId inRecord:(ABRecordRef)aRecord;
+- (BOOL)searchContactFields:(NSArray*)fields forMVDictionaryProperty:(ABPropertyID)propId withValue:(NSString*)testValue;
+
+@end
+
+// generic ContactField types
+#define kW3ContactFieldType @"type"
+#define kW3ContactFieldValue @"value"
+#define kW3ContactFieldPrimary @"pref"
+// Various labels for ContactField types
+#define kW3ContactWorkLabel @"work"
+#define kW3ContactHomeLabel @"home"
+#define kW3ContactOtherLabel @"other"
+#define kW3ContactPhoneWorkFaxLabel @"work fax"
+#define kW3ContactPhoneHomeFaxLabel @"home fax"
+#define kW3ContactPhoneMobileLabel @"mobile"
+#define kW3ContactPhonePagerLabel @"pager"
+#define kW3ContactPhoneIPhoneLabel @"iphone"
+#define kW3ContactPhoneMainLabel @"main"
+#define kW3ContactUrlBlog @"blog"
+#define kW3ContactUrlProfile @"profile"
+#define kW3ContactImAIMLabel @"aim"
+#define kW3ContactImICQLabel @"icq"
+#define kW3ContactImMSNLabel @"msn"
+#define kW3ContactImYahooLabel @"yahoo"
+#define kW3ContactImSkypeLabel @"skype"
+#define kW3ContactImFacebookMessengerLabel @"facebook"
+#define kW3ContactImGoogleTalkLabel @"gtalk"
+#define kW3ContactImJabberLabel @"jabber"
+#define kW3ContactImQQLabel @"qq"
+#define kW3ContactImGaduLabel @"gadu"  
+#define kW3ContactFieldId @"id"
+// special translation for IM field value and type
+#define kW3ContactImType @"type"
+#define kW3ContactImValue @"value"
+
+// Contact object
+#define kW3ContactId @"id"
+#define kW3ContactName @"name"
+#define kW3ContactFormattedName @"formatted"
+#define kW3ContactGivenName @"givenName"
+#define kW3ContactFamilyName @"familyName"
+#define kW3ContactMiddleName @"middleName"
+#define kW3ContactHonorificPrefix @"honorificPrefix"
+#define kW3ContactHonorificSuffix @"honorificSuffix"
+#define kW3ContactDisplayName @"displayName"
+#define kW3ContactNickname @"nickname"
+#define kW3ContactPhoneNumbers @"phoneNumbers"
+#define kW3ContactAddresses @"addresses"
+#define kW3ContactAddressFormatted @"formatted"
+#define kW3ContactStreetAddress @"streetAddress"
+#define kW3ContactLocality @"locality"
+#define kW3ContactRegion @"region"
+#define kW3ContactPostalCode @"postalCode"
+#define kW3ContactCountry @"country"
+#define kW3ContactEmails @"emails"
+#define kW3ContactIms @"ims"
+#define kW3ContactOrganizations @"organizations"
+#define kW3ContactOrganizationName @"name"
+#define kW3ContactTitle @"title"
+#define kW3ContactDepartment @"department"
+#define kW3ContactBirthday @"birthday"
+#define kW3ContactNote @"note"
+#define kW3ContactPhotos @"photos"
+#define kW3ContactCategories @"categories"
+#define kW3ContactUrls @"urls"

km0App/node_modules/cordova-plugin-contacts/src/ios/CDVContacts.h

+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+
+#import <Foundation/Foundation.h>
+#import <AddressBook/ABAddressBook.h>
+#import <AddressBookUI/AddressBookUI.h>
+#import <Cordova/CDVPlugin.h>
+#import "CDVContact.h"
+
+@interface CDVContacts : CDVPlugin <ABNewPersonViewControllerDelegate,
+                         ABPersonViewControllerDelegate,
+                         ABPeoplePickerNavigationControllerDelegate
+                         >
+{
+    ABAddressBookRef addressBook;
+}
+
+/*
+ * newContact - create a new contact via the GUI
+ *
+ * arguments:
+ *	1: successCallback: this is the javascript function that will be called with the newly created contactId
+ */
+- (void)newContact:(CDVInvokedUrlCommand*)command;
+
+/*
+ * displayContact  - IN PROGRESS
+ *
+ * arguments:
+ *	1: recordID of the contact to display in the iPhone contact display
+ *	2: successCallback - currently not used
+ *  3: error callback
+ * options:
+ *	allowsEditing: set to true to allow the user to edit the contact - currently not supported
+ */
+- (void)displayContact:(CDVInvokedUrlCommand*)command;
+
+/*
+ * chooseContact
+ *
+ * arguments:
+ *	1: this is the javascript function that will be called with the contact data as a JSON object (as the first param)
+ * options:
+ *	allowsEditing: set to true to not choose the contact, but to edit it in the iPhone contact editor
+ */
+- (void)chooseContact:(CDVInvokedUrlCommand*)command;
+
+- (void)newPersonViewController:(ABNewPersonViewController*)newPersonViewController didCompleteWithNewPerson:(ABRecordRef)person;
+- (BOOL)personViewController:(ABPersonViewController*)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person
+                    property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifierForValue;
+/*
+ * Launches the Contact Picker to select a single contact.
+ *
+ * arguments:
+ *	1: this is the javascript function that will be called with the contact data as a JSON object (as the first param)
+ * options:
+ *	desiredFields: ContactFields array to be returned back
+ */
+- (void)pickContact:(CDVInvokedUrlCommand*)command;
+
+/*
+ * search - searches for contacts.  Only person records are currently supported.
+ *
+ * arguments:
+ *  1: successcallback - this is the javascript function that will be called with the array of found contacts
+ *  2:  errorCallback - optional javascript function to be called in the event of an error with an error code.
+ * options:  dictionary containing ContactFields and ContactFindOptions
+ *	fields - ContactFields array
+ *  findOptions - ContactFindOptions object as dictionary
+ *
+ */
+- (void)search:(CDVInvokedUrlCommand*)command;
+
+/*
+ * save - saves a new contact or updates and existing contact
+ *
+ * arguments:
+ *  1: success callback - this is the javascript function that will be called with the JSON representation of the saved contact
+ *		search calls a fixed navigator.service.contacts._findCallback which then calls the success callback stored before making the call into obj-c
+ */
+- (void)save:(CDVInvokedUrlCommand*)command;
+
+/*
+ * remove - removes a contact from the address book
+ *
+ * arguments:
+ *  1:  1: successcallback - this is the javascript function that will be called with a (now) empty contact object
+ *
+ * options:  dictionary containing Contact object to remove
+ *	contact - Contact object as dictionary
+ */
+- (void)remove:(CDVInvokedUrlCommand*)command;
+
+// - (void) dealloc;
+
+@end
+
+@interface CDVContactsPicker : ABPeoplePickerNavigationController
+{
+    BOOL allowsEditing;
+    NSString* callbackId;
+    NSDictionary* options;
+    NSDictionary* pickedContactDictionary;
+}
+
+@property BOOL allowsEditing;
+@property (copy) NSString* callbackId;
+@property (nonatomic, strong) NSDictionary* options;
+@property (nonatomic, strong) NSDictionary* pickedContactDictionary;
+
+@end
+
+@interface CDVNewContactsController : ABNewPersonViewController
+{
+    NSString* callbackId;
+}
+@property (copy) NSString* callbackId;
+@end
+
+/* ABPersonViewController does not have any UI to dismiss.  Adding navigationItems to it does not work properly,  the navigationItems are lost when the app goes into the background.
+    The solution was to create an empty NavController in front of the ABPersonViewController. This
+    causes the ABPersonViewController to have a back button. By subclassing the ABPersonViewController,
+    we can override viewWillDisappear and take down the entire NavigationController at that time.
+ */
+@interface CDVDisplayContactViewController : ABPersonViewController
+{}
+@property (nonatomic, strong) CDVPlugin* contactsPlugin;
+
+@end
+@interface CDVAddressBookAccessError : NSObject
+{}
+@property (assign) CDVContactError errorCode;
+- (CDVAddressBookAccessError*)initWithCode:(CDVContactError)code;
+@end
+
+typedef void (^ CDVAddressBookWorkerBlock)(
+    ABAddressBookRef         addressBook,
+    CDVAddressBookAccessError* error
+    );
+@interface CDVAddressBookHelper : NSObject
+{}
+
+- (void)createAddressBook:(CDVAddressBookWorkerBlock)workerBlock;
+@end

km0App/node_modules/cordova-plugin-contacts/src/ios/CDVContacts.m

+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ */
+
+#import "CDVContacts.h"
+#import <UIKit/UIKit.h>
+
+@implementation CDVContactsPicker
+
+@synthesize allowsEditing;
+@synthesize callbackId;
+@synthesize options;
+@synthesize pickedContactDictionary;
+
+@end
+@implementation CDVNewContactsController
+
+@synthesize callbackId;
+
+@end
+
+@implementation CDVContacts
+
+// overridden to clean up Contact statics
+- (void)onAppTerminate
+{
+    // NSLog(@"Contacts::onAppTerminate");
+}
+
+// iPhone only method to create a new contact through the GUI
+- (void)newContact:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+
+    CDVAddressBookHelper* abHelper = [[CDVAddressBookHelper alloc] init];
+    CDVContacts* __weak weakSelf = self;  // play it safe to avoid retain cycles
+
+    [abHelper createAddressBook: ^(ABAddressBookRef addrBook, CDVAddressBookAccessError* errCode) {
+        if (addrBook == NULL) {
+            // permission was denied or other error just return (no error callback)
+            return;
+        }
+        CDVNewContactsController* npController = [[CDVNewContactsController alloc] init];
+        npController.addressBook = addrBook;     // a CF retaining assign
+        CFRelease(addrBook);
+
+        npController.newPersonViewDelegate = self;
+        npController.callbackId = callbackId;
+
+        UINavigationController* navController = [[UINavigationController alloc] initWithRootViewController:npController];
+
+        [weakSelf.viewController presentViewController:navController animated:YES completion:nil];
+    }];
+}
+
+- (void)newPersonViewController:(ABNewPersonViewController*)newPersonViewController didCompleteWithNewPerson:(ABRecordRef)person
+{
+    ABRecordID recordId = kABRecordInvalidID;
+    CDVNewContactsController* newCP = (CDVNewContactsController*)newPersonViewController;
+    NSString* callbackId = newCP.callbackId;
+
+    if (person != NULL) {
+        // return the contact id
+        recordId = ABRecordGetRecordID(person);
+    }
+
+    [[newPersonViewController presentingViewController] dismissViewControllerAnimated:YES completion:^{
+     CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsInt:recordId];
+     [self.commandDelegate sendPluginResult:result callbackId:callbackId];
+    }];
+}
+
+- (bool)existsValue:(NSDictionary*)dict val:(NSString*)expectedValue forKey:(NSString*)key
+{
+    id val = [dict valueForKey:key];
+    bool exists = false;
+    
+    if (val != nil) {
+        exists = [(NSString*)val compare : expectedValue options : NSCaseInsensitiveSearch] == 0;
+    }
+    
+    return exists;
+}
+
+- (void)displayContact:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+    ABRecordID recordID = [[command argumentAtIndex:0] intValue];
+    NSDictionary* options = [command argumentAtIndex:1 withDefault:[NSNull null]];
+    bool bEdit = [options isKindOfClass:[NSNull class]] ? false : [self existsValue:options val:@"true" forKey:@"allowsEditing"];
+
+    CDVAddressBookHelper* abHelper = [[CDVAddressBookHelper alloc] init];
+    CDVContacts* __weak weakSelf = self;  // play it safe to avoid retain cycles
+
+    [abHelper createAddressBook: ^(ABAddressBookRef addrBook, CDVAddressBookAccessError* errCode) {
+        if (addrBook == NULL) {
+            // permission was denied or other error - return error
+            CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageToErrorObject:errCode ? (int)errCode.errorCode:UNKNOWN_ERROR];
+            [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+            return;
+        }
+        ABRecordRef rec = ABAddressBookGetPersonWithRecordID(addrBook, recordID);
+
+        if (rec) {
+            CDVDisplayContactViewController* personController = [[CDVDisplayContactViewController alloc] init];
+            personController.displayedPerson = rec;
+            personController.personViewDelegate = self;
+            personController.allowsEditing = NO;
+
+            // create this so DisplayContactViewController will have a "back" button.
+            UIViewController* parentController = [[UIViewController alloc] init];
+            UINavigationController* navController = [[UINavigationController alloc] initWithRootViewController:parentController];
+
+            [navController pushViewController:personController animated:YES];
+
+            [self.viewController presentViewController:navController animated:YES completion:nil];
+
+            if (bEdit) {
+                // create the editing controller and push it onto the stack
+                ABPersonViewController* editPersonController = [[ABPersonViewController alloc] init];
+                editPersonController.displayedPerson = rec;
+                editPersonController.personViewDelegate = self;
+                editPersonController.allowsEditing = YES;
+                [navController pushViewController:editPersonController animated:YES];
+            }
+        } else {
+            // no record, return error
+            CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:UNKNOWN_ERROR];
+            [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+        }
+        CFRelease(addrBook);
+    }];
+}
+
+- (BOOL)personViewController:(ABPersonViewController*)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person
+                    property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifierForValue
+{
+    return YES;
+}
+
+- (void)chooseContact:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+    NSDictionary* options = [command argumentAtIndex:0 withDefault:[NSNull null]];
+
+    CDVContactsPicker* pickerController = [[CDVContactsPicker alloc] init];
+
+    pickerController.peoplePickerDelegate = self;
+    pickerController.callbackId = callbackId;
+    pickerController.options = options;
+    pickerController.pickedContactDictionary = [NSDictionary dictionaryWithObjectsAndKeys:[NSNumber numberWithInt:kABRecordInvalidID], kW3ContactId, nil];
+    id allowsEditingValue = [options valueForKey:@"allowsEditing"];
+    BOOL allowsEditing = NO;
+    if ([allowsEditingValue isKindOfClass:[NSNumber class]]) {
+        allowsEditing = [(NSNumber*)allowsEditingValue boolValue];
+    }
+    pickerController.allowsEditing = allowsEditing;
+
+    [self.viewController presentViewController:pickerController animated:YES completion:nil];
+}
+
+- (void)pickContact:(CDVInvokedUrlCommand *)command
+{
+    // mimic chooseContact method call with required for us parameters
+    NSArray* desiredFields = [command argumentAtIndex:0 withDefault:[NSArray array]];
+    if (desiredFields == nil || desiredFields.count == 0) {
+        desiredFields = [NSArray arrayWithObjects:@"*", nil];
+    }
+    NSMutableDictionary* options = [NSMutableDictionary dictionaryWithCapacity:2];
+    
+    [options setObject: desiredFields forKey:@"fields"];
+    [options setObject: [NSNumber numberWithBool: FALSE] forKey:@"allowsEditing"];
+    
+    NSArray* args = [NSArray arrayWithObjects:options, nil];
+    
+    CDVInvokedUrlCommand* newCommand = [[CDVInvokedUrlCommand alloc] initWithArguments:args
+                 callbackId:command.callbackId
+                  className:command.className
+                 methodName:command.methodName];
+
+    // First check for Address book permissions
+    ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();
+    if (status == kABAuthorizationStatusAuthorized) {
+        [self chooseContact:newCommand];
+        return;
+    }
+
+    CDVPluginResult *errorResult = [CDVPluginResult resultWithStatus: CDVCommandStatus_ERROR messageAsInt:PERMISSION_DENIED_ERROR];
+
+    // if the access is already restricted/denied the only way is to fail
+    if (status == kABAuthorizationStatusRestricted || status == kABAuthorizationStatusDenied) {
+        [self.commandDelegate sendPluginResult: errorResult callbackId:command.callbackId];
+        return;
+    }
+
+    // if no permissions granted try to request them first
+    if (status == kABAuthorizationStatusNotDetermined) {
+        ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
+            if (granted) {
+                [self chooseContact:newCommand];
+                return;
+            }
+
+            [self.commandDelegate sendPluginResult: errorResult callbackId:command.callbackId];
+        });
+    }
+}
+
+- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker
+      shouldContinueAfterSelectingPerson:(ABRecordRef)person
+{
+    [self peoplePickerNavigationController:peoplePicker didSelectPerson:person];
+    return NO;
+}
+
+- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker
+      shouldContinueAfterSelectingPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
+{
+    return YES;
+}
+
+- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController*)peoplePicker
+{
+    // return contactId or invalid if none picked
+    CDVContactsPicker* picker = (CDVContactsPicker*)peoplePicker;
+
+    if (picker.allowsEditing) {
+        // get the info after possible edit
+        // if we got this far, user has already approved/ disapproved addressBook access
+        ABAddressBookRef addrBook = ABAddressBookCreateWithOptions(NULL, NULL);
+        ABRecordRef person = ABAddressBookGetPersonWithRecordID(addrBook, (int)[[picker.pickedContactDictionary objectForKey:kW3ContactId] integerValue]);
+        if (person) {
+            CDVContact* pickedContact = [[CDVContact alloc] initFromABRecord:(ABRecordRef)person];
+            NSArray* fields = [picker.options objectForKey:@"fields"];
+            NSDictionary* returnFields = [[CDVContact class] calcReturnFields:fields];
+            picker.pickedContactDictionary = [pickedContact toDictionary:returnFields];
+        }
+        CFRelease(addrBook);
+    }
+    
+    NSNumber* recordId = picker.pickedContactDictionary[kW3ContactId];
+    
+    [[peoplePicker presentingViewController] dismissViewControllerAnimated:YES completion:^{
+        CDVPluginResult* result = nil;
+        if ([recordId isEqualToNumber:[NSNumber numberWithInt:kABRecordInvalidID]]) {
+            result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:OPERATION_CANCELLED_ERROR] ;
+        } else {
+            result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:picker.pickedContactDictionary];
+        }
+        [self.commandDelegate sendPluginResult:result callbackId:picker.callbackId];
+    }];
+}
+
+// Called after a person has been selected by the user.
+- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker didSelectPerson:(ABRecordRef)person
+{
+    CDVContactsPicker* picker = (CDVContactsPicker*)peoplePicker;
+    NSNumber* pickedId = [NSNumber numberWithInt:ABRecordGetRecordID(person)];
+    
+    if (picker.allowsEditing) {
+        ABPersonViewController* personController = [[ABPersonViewController alloc] init];
+        personController.displayedPerson = person;
+        personController.personViewDelegate = self;
+        personController.allowsEditing = picker.allowsEditing;
+        // store id so can get info in peoplePickerNavigationControllerDidCancel
+        picker.pickedContactDictionary = [NSDictionary dictionaryWithObjectsAndKeys:pickedId, kW3ContactId, nil];
+        
+        [peoplePicker pushViewController:personController animated:YES];
+    } else {
+        // Retrieve and return pickedContact information
+        CDVContact* pickedContact = [[CDVContact alloc] initFromABRecord:(ABRecordRef)person];
+        NSArray* fields = [picker.options objectForKey:@"fields"];
+        NSDictionary* returnFields = [[CDVContact class] calcReturnFields:fields];
+        picker.pickedContactDictionary = [pickedContact toDictionary:returnFields];
+        
+        [[picker presentingViewController] dismissViewControllerAnimated:YES completion:^{
+            CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:picker.pickedContactDictionary];
+            [self.commandDelegate sendPluginResult:result callbackId:picker.callbackId];
+        }];
+    }
+}
+
+// Called after a property has been selected by the user.
+- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
+{
+    // not implemented
+}
+
+- (void)search:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+    NSArray* fields = [command argumentAtIndex:0];
+    NSDictionary* findOptions = [command argumentAtIndex:1 withDefault:[NSNull null]];
+
+    [self.commandDelegate runInBackground:^{
+        // from Apple:  Important You must ensure that an instance of ABAddressBookRef is used by only one thread.
+        // which is why address book is created within the dispatch queue.
+        // more details here: http: //blog.byadrian.net/2012/05/05/ios-addressbook-framework-and-gcd/
+        CDVAddressBookHelper* abHelper = [[CDVAddressBookHelper alloc] init];
+        CDVContacts* __weak weakSelf = self;     // play it safe to avoid retain cycles
+        // it gets uglier, block within block.....
+        [abHelper createAddressBook: ^(ABAddressBookRef addrBook, CDVAddressBookAccessError* errCode) {
+            if (addrBook == NULL) {
+                // permission was denied or other error - return error
+                CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageToErrorObject:errCode ? (int)errCode.errorCode:UNKNOWN_ERROR];
+                [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+                return;
+            }
+
+            NSArray* foundRecords = nil;
+            // get the findOptions values
+            BOOL multiple = NO;         // default is false
+            NSString* filter = nil;
+            NSArray* desiredFields = nil;
+            if (![findOptions isKindOfClass:[NSNull class]]) {
+                id value = nil;
+                id filterValue = [findOptions objectForKey:@"filter"];
+                BOOL filterValueIsNumber = [filterValue isKindOfClass:[NSNumber class]];
+                filter = filterValueIsNumber ? [filterValue stringValue] : (NSString *) filterValue;
+                value = [findOptions objectForKey:@"multiple"];
+                if ([value isKindOfClass:[NSNumber class]]) {
+                    // multiple is a boolean that will come through as an NSNumber
+                    multiple = [(NSNumber*)value boolValue];
+                    // NSLog(@"multiple is: %d", multiple);
+                }
+                desiredFields = [findOptions objectForKey:@"desiredFields"];
+                // return all fields if desired fields are not explicitly defined
+                if (desiredFields == nil || desiredFields.count == 0) {
+                    desiredFields = [NSArray arrayWithObjects:@"*", nil];
+                }
+            }
+
+            NSDictionary* searchFields = [[CDVContact class] calcReturnFields:fields];
+            NSDictionary* returnFields = [[CDVContact class] calcReturnFields:desiredFields];
+
+            NSMutableArray* matches = nil;
+            if (!filter || [filter isEqualToString:@""]) {
+                // get all records
+                foundRecords = (__bridge_transfer NSArray*)ABAddressBookCopyArrayOfAllPeople(addrBook);
+                if (foundRecords && ([foundRecords count] > 0)) {
+                    // create Contacts and put into matches array
+                    // doesn't make sense to ask for all records when multiple == NO but better check
+                    int xferCount = multiple == YES ? (int)[foundRecords count] : 1;
+                    matches = [NSMutableArray arrayWithCapacity:xferCount];
+
+                    for (int k = 0; k < xferCount; k++) {
+                        CDVContact* xferContact = [[CDVContact alloc] initFromABRecord:(__bridge ABRecordRef)[foundRecords objectAtIndex:k]];
+                        [matches addObject:xferContact];
+                        xferContact = nil;
+                    }
+                }
+            } else {
+                foundRecords = (__bridge_transfer NSArray*)ABAddressBookCopyArrayOfAllPeople(addrBook);
+                matches = [NSMutableArray arrayWithCapacity:1];
+                BOOL bFound = NO;
+                int testCount = (int)[foundRecords count];
+
+                for (int j = 0; j < testCount; j++) {
+                    CDVContact* testContact = [[CDVContact alloc] initFromABRecord:(__bridge ABRecordRef)[foundRecords objectAtIndex:j]];
+                    if (testContact) {
+                        bFound = [testContact foundValue:filter inFields:searchFields];
+                        if (bFound) {
+                            [matches addObject:testContact];
+                        }
+                        testContact = nil;
+                    }
+                }
+            }
+            NSMutableArray* returnContacts = [NSMutableArray arrayWithCapacity:1];
+
+            if ((matches != nil) && ([matches count] > 0)) {
+                // convert to JS Contacts format and return in callback
+                // - returnFields  determines what properties to return
+                @autoreleasepool {
+                    int count = multiple == YES ? (int)[matches count] : 1;
+
+                    for (int i = 0; i < count; i++) {
+                        CDVContact* newContact = [matches objectAtIndex:i];
+                        NSDictionary* aContact = [newContact toDictionary:returnFields];
+                        [returnContacts addObject:aContact];
+                    }
+                }
+            }
+            // return found contacts (array is empty if no contacts found)
+            CDVPluginResult* result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsArray:returnContacts];
+            [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+            // NSLog(@"findCallback string: %@", jsString);
+
+            if (addrBook) {
+                CFRelease(addrBook);
+            }
+        }];
+    }];     // end of workQueue block
+
+    return;
+}
+
+- (void)save:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+    NSDictionary* contactDict = [command argumentAtIndex:0];
+
+    [self.commandDelegate runInBackground:^{
+        CDVAddressBookHelper* abHelper = [[CDVAddressBookHelper alloc] init];
+        CDVContacts* __weak weakSelf = self;     // play it safe to avoid retain cycles
+
+        [abHelper createAddressBook: ^(ABAddressBookRef addrBook, CDVAddressBookAccessError* errorCode) {
+            CDVPluginResult* result = nil;
+            if (addrBook == NULL) {
+                // permission was denied or other error - return error
+                result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:errorCode ? (int)errorCode.errorCode:UNKNOWN_ERROR];
+                [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+                return;
+            }
+
+            bool bIsError = FALSE, bSuccess = FALSE;
+            BOOL bUpdate = NO;
+            CDVContactError errCode = UNKNOWN_ERROR;
+            CFErrorRef error;
+            NSNumber* cId = [contactDict valueForKey:kW3ContactId];
+            CDVContact* aContact = nil;
+            ABRecordRef rec = nil;
+            if (cId && ![cId isKindOfClass:[NSNull class]]) {
+                rec = ABAddressBookGetPersonWithRecordID(addrBook, [cId intValue]);
+                if (rec) {
+                    aContact = [[CDVContact alloc] initFromABRecord:rec];
+                    bUpdate = YES;
+                }
+            }
+            if (!aContact) {
+                aContact = [[CDVContact alloc] init];
+            }
+
+            bSuccess = [aContact setFromContactDict:contactDict asUpdate:bUpdate];
+            if (bSuccess) {
+                if (!bUpdate) {
+                    bSuccess = ABAddressBookAddRecord(addrBook, [aContact record], &error);
+                }
+                if (bSuccess) {
+                    bSuccess = ABAddressBookSave(addrBook, &error);
+                }
+                if (!bSuccess) {         // need to provide error codes
+                    bIsError = TRUE;
+                    errCode = IO_ERROR;
+                } else {
+                    // give original dictionary back?  If generate dictionary from saved contact, have no returnFields specified
+                    // so would give back all fields (which W3C spec. indicates is not desired)
+                    // for now (while testing) give back saved, full contact
+                    NSDictionary* newContact = [aContact toDictionary:[CDVContact defaultFields]];
+                    // NSString* contactStr = [newContact JSONRepresentation];
+                    result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary:newContact];
+                }
+            } else {
+                bIsError = TRUE;
+                errCode = IO_ERROR;
+            }
+            CFRelease(addrBook);
+
+            if (bIsError) {
+                result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:(int)errCode];
+            }
+
+            if (result) {
+                [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+            }
+        }];
+    }];     // end of  queue
+}
+
+- (void)remove:(CDVInvokedUrlCommand*)command
+{
+    NSString* callbackId = command.callbackId;
+    NSNumber* cId = [command argumentAtIndex:0];
+
+    CDVAddressBookHelper* abHelper = [[CDVAddressBookHelper alloc] init];
+    CDVContacts* __weak weakSelf = self;  // play it safe to avoid retain cycles
+
+    [abHelper createAddressBook: ^(ABAddressBookRef addrBook, CDVAddressBookAccessError* errorCode) {
+        CDVPluginResult* result = nil;
+        if (addrBook == NULL) {
+            // permission was denied or other error - return error
+            result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:errorCode ? (int)errorCode.errorCode:UNKNOWN_ERROR];
+            [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+            return;
+        }
+
+        bool bIsError = FALSE, bSuccess = FALSE;
+        CDVContactError errCode = UNKNOWN_ERROR;
+        CFErrorRef error;
+        ABRecordRef rec = nil;
+        if (cId && ![cId isKindOfClass:[NSNull class]] && ([cId intValue] != kABRecordInvalidID)) {
+            rec = ABAddressBookGetPersonWithRecordID(addrBook, [cId intValue]);
+            if (rec) {
+                bSuccess = ABAddressBookRemoveRecord(addrBook, rec, &error);
+                if (!bSuccess) {
+                    bIsError = TRUE;
+                    errCode = IO_ERROR;
+                } else {
+                    bSuccess = ABAddressBookSave(addrBook, &error);
+                    if (!bSuccess) {
+                        bIsError = TRUE;
+                        errCode = IO_ERROR;
+                    } else {
+                        // set id to null
+                        // [contactDict setObject:[NSNull null] forKey:kW3ContactId];
+                        // result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsDictionary: contactDict];
+                        result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+                        // NSString* contactStr = [contactDict JSONRepresentation];
+                    }
+                }
+            } else {
+                // no record found return error
+                bIsError = TRUE;
+                errCode = UNKNOWN_ERROR;
+            }
+        } else {
+            // invalid contact id provided
+            bIsError = TRUE;
+            errCode = INVALID_ARGUMENT_ERROR;
+        }
+
+        if (addrBook) {
+            CFRelease(addrBook);
+        }
+        if (bIsError) {
+            result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsInt:(int)errCode];
+        }
+        if (result) {
+            [weakSelf.commandDelegate sendPluginResult:result callbackId:callbackId];
+        }
+    }];
+    return;
+}
+
+@end
+
+/* ABPersonViewController does not have any UI to dismiss.  Adding navigationItems to it does not work properly
+ * The navigationItems are lost when the app goes into the background.  The solution was to create an empty
+ * NavController in front of the ABPersonViewController. This will cause the ABPersonViewController to have a back button. By subclassing the ABPersonViewController, we can override viewDidDisappear and take down the entire NavigationController.
+ */
+@implementation CDVDisplayContactViewController
+@synthesize contactsPlugin;
+
+- (void)viewWillDisappear:(BOOL)animated
+{
+    [super viewWillDisappear:animated];
+
+    [[self presentingViewController] dismissViewControllerAnimated:YES completion:nil];
+}
+
+@end
+@implementation CDVAddressBookAccessError
+
+@synthesize errorCode;
+
+- (CDVAddressBookAccessError*)initWithCode:(CDVContactError)code
+{
+    self = [super init];
+    if (self) {
+        self.errorCode = code;
+    }
+    return self;
+}
+
+@end
+
+@implementation CDVAddressBookHelper
+
+/**
+ * NOTE: workerBlock is responsible for releasing the addressBook that is passed to it
+ */
+- (void)createAddressBook:(CDVAddressBookWorkerBlock)workerBlock
+{
+    // TODO: this probably should be reworked - seems like the workerBlock can just create and release its own AddressBook,
+    // and also this important warning from (http://developer.apple.com/library/ios/#documentation/ContactData/Conceptual/AddressBookProgrammingGuideforiPhone/Chapters/BasicObjects.html):
+    // "Important: Instances of ABAddressBookRef cannot be used by multiple threads. Each thread must make its own instance."
+    ABAddressBookRef addressBook;
+
+    CFErrorRef error = nil;
+    // CFIndex status = ABAddressBookGetAuthorizationStatus();
+    addressBook = ABAddressBookCreateWithOptions(NULL, &error);
+    // NSLog(@"addressBook access: %lu", status);
+    ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
+            // callback can occur in background, address book must be accessed on thread it was created on
+            dispatch_sync(dispatch_get_main_queue(), ^{
+                if (error) {
+                    workerBlock(NULL, [[CDVAddressBookAccessError alloc] initWithCode:UNKNOWN_ERROR]);
+                } else if (!granted) {
+                    workerBlock(NULL, [[CDVAddressBookAccessError alloc] initWithCode:PERMISSION_DENIED_ERROR]);
+                } else {
+                    // access granted
+                    workerBlock(addressBook, [[CDVAddressBookAccessError alloc] initWithCode:UNKNOWN_ERROR]);
+                }
+            });
+        });
+}
+
+@end

km0App/node_modules/cordova-plugin-contacts/src/ubuntu/contacts.cpp

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+#include "contacts.h"
+
+#if defined QTCONTACTS_USE_NAMESPACE
+QTCONTACTS_USE_NAMESPACE
+#endif
+
+Contacts::Contacts(Cordova *cordova): CPlugin(cordova) {
+    m_fieldNamePairs.clear();
+
+    m_fieldNamePairs["displayName"] = QContactDetail::TypeDisplayLabel;
+    m_fieldNamePairs["name"] = QContactDetail::TypeName;
+    m_fieldNamePairs["nickname"] = QContactDetail::TypeNickname;
+    m_fieldNamePairs["phoneNumbers"] = QContactDetail::TypePhoneNumber;
+    m_fieldNamePairs["emails"] = QContactDetail::TypeEmailAddress;
+    m_fieldNamePairs["addresses"] = QContactDetail::TypeAddress;
+    m_fieldNamePairs["ims"] = QContactDetail::TypeOnlineAccount;
+    m_fieldNamePairs["organizations"] = QContactDetail::TypeOrganization;
+    m_fieldNamePairs["birthday"] = QContactDetail::TypeBirthday;
+    m_fieldNamePairs["note"] = QContactDetail::TypeNote;
+    m_fieldNamePairs["photos"] = QContactDetail::TypeAvatar;
+    m_fieldNamePairs["urls"] = QContactDetail::TypeUrl;
+
+    m_notSupportedFields.clear();
+    m_notSupportedFields << "categories";
+    m_manager.clear();
+    m_manager = QSharedPointer<QContactManager>(new QContactManager());
+}
+
+void Contacts::save(int scId, int ecId, const QVariantMap &params) {
+    QContact result;
+    QList<QContactDetail *> detailsToDelete;
+
+    if (params.find("id") != params.end()) {
+        QString id = params.find("id")->toString();
+        if (!id.isEmpty()) {
+            result = m_manager->contact(QContactId::fromString(id));
+            result.clearDetails();
+        }
+    }
+
+    foreach (QString field, params.keys()) {
+        QContactDetail::DetailType qtDefinition = cordovaFieldNameToQtDefinition(field);
+        if (qtDefinition == QContactDetail::TypeUndefined)
+            continue;
+
+        if (field == "nickname") {
+            QContactNickname *detail = new QContactNickname;
+            detail->setNickname(params[field].toString());
+            detailsToDelete << detail;
+            result.saveDetail(detail);
+        } else if (field == "note") {
+            QContactNote *detail = new QContactNote;
+            detail->setNote(params[field].toString());
+            detailsToDelete << detail;
+            result.saveDetail(detail);
+        } else if (field == "phoneNumbers") {
+            if (params[field].type() != QVariant::List)
+                continue;
+            QVariantList phonesList = params[field].toList();
+            foreach (const QVariant &phoneDesc, phonesList) {
+                if (phoneDesc.type() != QVariant::Map)
+                    continue;
+                QContactPhoneNumber *detail = new QContactPhoneNumber;
+                detail->setNumber(phoneDesc.toMap()["value"].toString());
+                if (!phoneDesc.toMap()["type"].toString().isEmpty() &&
+                        phoneDesc.toMap()["type"].toString() != "phone")
+                    detail->setSubTypes(QList<int>() <<
+                                        subTypePhoneFromString(phoneDesc.toMap()["type"].toString()));
+                detailsToDelete << detail;
+                result.saveDetail(detail);
+            }
+        } else if (field == "emails") {
+            if (params[field].type() != QVariant::List)
+                continue;
+            QVariantList emailsList = params[field].toList();
+            foreach (const QVariant &emailDesc, emailsList) {
+                if (emailDesc.type() != QVariant::Map)
+                    continue;
+                if (emailDesc.toMap()["value"].toString().isEmpty())
+                    continue;
+                QContactEmailAddress *detail = new QContactEmailAddress;
+                detail->setEmailAddress(emailDesc.toMap()["value"].toString());
+                detailsToDelete << detail;
+                result.saveDetail(detail);
+            }
+        } else if (field == "ims") {
+            if (params[field].type() != QVariant::List)
+                continue;
+            QVariantList imsList = params[field].toList();
+            foreach (const QVariant &imDesc, imsList) {
+                if (imDesc.type() != QVariant::Map)
+                    continue;
+                QContactOnlineAccount *detail = new QContactOnlineAccount;
+                detail->setAccountUri(imDesc.toMap()["value"].toString());
+                if (!imDesc.toMap()["type"].toString().isEmpty())
+                    detail->setSubTypes(QList<int>() <<
+                                        subTypeOnlineAccountFromString(imDesc.toMap()["type"].toString()));
+                detailsToDelete << detail;
+                result.saveDetail(detail);
+            }
+        } else if (field == "photos") {
+            if (params[field].type() != QVariant::List)
+                continue;
+            QVariantList photosList = params[field].toList();
+            foreach (const QVariant &photoDesc, photosList) {
+                if (photoDesc.type() != QVariant::Map)
+                    continue;
+                //TODO: we need to decide should we support base64 images or not
+                if (photoDesc.toMap()["type"].toString() != "url")
+                    continue;
+                QContactAvatar *detail = new QContactAvatar;
+                detail->setImageUrl(QUrl(photoDesc.toMap()["value"].toString()));
+                detailsToDelete << detail;
+                result.saveDetail(detail);
+            }
+        } else if (field == "urls") {
+            if (params[field].type() != QVariant::List)
+                continue;
+            QVariantList urlsList = params[field].toList();
+            foreach (const QVariant &urlDesc, urlsList) {
+                if (urlDesc.type() != QVariant::Map)
+                    continue;
+                QContactUrl *detail = new QContactUrl;
+                detail->setUrl(urlDesc.toMap()["value"].toString());
+                if (!urlDesc.toMap()["type"].toString().isEmpty())
+                    detail->setSubType((QContactUrl::SubType) subTypeUrlFromString(urlDesc.toMap()["type"].toString()));
+                detailsToDelete << detail;
+                result.saveDetail(detail);
+            }
+        } else if (field == "birthday") {
+            QDateTime birthday;
+            birthday.setTime_t(params[field].toLongLong() / 1000);
+
+            QContactBirthday *detail = new QContactBirthday;
+            detail->setDateTime(birthday);
+            detailsToDelete << detail;
+            result.saveDetail(detail);
+        } else if (field == "organizations") {
+
+            if (params[field].type() != QVariant::List)
+                continue;
+            QVariantList organizationsList = params[field].toList();
+            foreach (const QVariant &organizationDesc, organizationsList) {
+                if (organizationDesc.type() != QVariant::Map)
+                    continue;
+                QContactOrganization *detail = new QContactOrganization;
+                detail->setName(organizationDesc.toMap()["name"].toString());
+                detail->setDepartment(QStringList() << organizationDesc.toMap()["department"].toString());
+                detail->setRole(organizationDesc.toMap()["title"].toString());
+                detailsToDelete << detail;
+                result.saveDetail(detail);
+            }
+
+        } else if (field == "name") {
+            QContactName *detail = new QContactName;
+            QVariantMap nameMap = params[field].toMap();
+            detail->setLastName(nameMap["familyName"].toString());
+            detail->setFirstName(nameMap["givenName"].toString());
+            detail->setMiddleName(nameMap["middleName"].toString());
+            detail->setPrefix(nameMap["honorificPrefix"].toString());
+            detail->setSuffix(nameMap["honorificSuffix"].toString());
+            detailsToDelete << detail;
+            result.saveDetail(detail);
+        }
+
+    }
+    if (!m_manager->saveContact(&result)) {
+        switch (m_manager->error()) {
+        case QContactManager::DoesNotExistError:
+        case QContactManager::AlreadyExistsError:
+        case QContactManager::InvalidDetailError:
+        case QContactManager::InvalidRelationshipError:
+        case QContactManager::BadArgumentError:
+        case QContactManager::InvalidContactTypeError:
+            callback(ecId, "ContactError.INVALID_ARGUMENT_ERROR");
+            break;
+        case QContactManager::DetailAccessError:
+        case QContactManager::PermissionsError:
+            callback(ecId, "ContactError.PERMISSION_DENIED_ERROR");
+            break;
+        case QContactManager::NotSupportedError:
+            callback(ecId, "ContactError.NOT_SUPPORTED_ERROR");
+            break;
+        case QContactManager::TimeoutError:
+            callback(ecId, "ContactError.TIMEOUT_ERROR");
+            break;
+        case QContactManager::UnspecifiedError:
+        case QContactManager::LockedError:
+        case QContactManager::OutOfMemoryError:
+        case QContactManager::VersionMismatchError:
+        case QContactManager::LimitReachedError:
+        case QContactManager::NoError:
+        default:
+            callback(ecId, "ContactError.UNKNOWN_ERROR");
+            break;
+        }
+    } else {
+        callback(scId, jsonedContact(result));
+    }
+    qDeleteAll(detailsToDelete);
+}
+
+void Contacts::remove(int scId, int ecId, const QString &localId) {
+    QContactId id = QContactId::fromString(localId);
+
+    if (!m_manager->removeContact(id)) {
+        switch (m_manager->error()) {
+        case QContactManager::AlreadyExistsError:
+        case QContactManager::InvalidDetailError:
+        case QContactManager::InvalidRelationshipError:
+        case QContactManager::BadArgumentError:
+        case QContactManager::InvalidContactTypeError:
+            callback(ecId, "ContactError.INVALID_ARGUMENT_ERROR");
+            break;
+        case QContactManager::DetailAccessError:
+        case QContactManager::PermissionsError:
+            callback(ecId, "ContactError.PERMISSION_DENIED_ERROR");
+            break;
+        case QContactManager::NotSupportedError:
+            callback(ecId, "ContactError.NOT_SUPPORTED_ERROR");
+            break;
+        case QContactManager::TimeoutError:
+            callback(ecId, "ContactError.TIMEOUT_ERROR");
+            break;
+        case QContactManager::UnspecifiedError:
+        case QContactManager::LockedError:
+        case QContactManager::OutOfMemoryError:
+        case QContactManager::VersionMismatchError:
+        case QContactManager::LimitReachedError:
+        case QContactManager::NoError:
+        case QContactManager::DoesNotExistError:
+        default:
+            callback(ecId, "ContactError.UNKNOWN_ERROR");
+            break;
+        }
+
+    } else {
+        cb(scId);
+    }
+}
+
+void Contacts::search(int scId, int ecId, const QStringList &fields, const QVariantMap &params) {
+    QString filter;
+    bool multiple = true;
+
+    if (params.find("filter") != params.end()) {
+        filter = params["filter"].toString();
+    }
+    if (params.find("multiple") != params.end()) {
+        multiple = params["multiple"].toBool();
+    }
+
+    findContacts(scId, ecId, fields, filter, multiple);
+}
+
+void Contacts::findContacts(int scId, int ecId, const QStringList &fields, const QString &filter, bool multiple) {
+    if (fields.length() <= 0){
+        callback(ecId, "new ContactError(ContactError.INVALID_ARGUMENT_ERROR)");
+    }
+
+    QContactUnionFilter unionFilter;
+
+    QMap<QContactDetail::DetailType, QList<int> > fieldNames;
+    fieldNames[QContactDetail::TypeDisplayLabel] << QContactDisplayLabel::FieldLabel;
+    fieldNames[QContactDetail::TypeName] << QContactName::FieldFirstName << QContactName::FieldLastName << QContactName::FieldMiddleName << QContactName::FieldPrefix << QContactName::FieldSuffix;
+    fieldNames[QContactDetail::TypeNickname] << QContactNickname::FieldNickname;
+    fieldNames[QContactDetail::TypePhoneNumber] << QContactPhoneNumber::FieldNumber;
+    fieldNames[QContactDetail::TypeEmailAddress] << QContactEmailAddress::FieldEmailAddress;
+    fieldNames[QContactDetail::TypeAddress] << QContactAddress::FieldCountry << QContactAddress::FieldLocality << QContactAddress::FieldPostcode << QContactAddress::FieldPostOfficeBox << QContactAddress::FieldRegion << QContactAddress::FieldStreet;
+    fieldNames[QContactDetail::TypeOnlineAccount] << QContactOnlineAccount::FieldAccountUri;
+    fieldNames[QContactDetail::TypeOrganization] << QContactOrganization::FieldAssistantName << QContactOrganization::FieldDepartment << QContactOrganization::FieldLocation << QContactOrganization::FieldName << QContactOrganization::FieldRole << QContactOrganization::FieldTitle;
+    fieldNames[QContactDetail::TypeBirthday] << QContactBirthday::FieldBirthday;
+    fieldNames[QContactDetail::TypeNote] << QContactNote::FieldNote;
+    fieldNames[QContactDetail::TypeUrl] << QContactUrl::FieldUrl;
+
+    foreach (const QContactDetail::DetailType &defName, fieldNames.keys()) {
+        foreach(int fieldName, fieldNames[defName]) {
+            QContactDetailFilter subFilter;
+            subFilter.setDetailType(defName, fieldName);
+            subFilter.setValue(filter);
+            subFilter.setMatchFlags(QContactFilter::MatchContains);
+            unionFilter.append(subFilter);
+        }
+    }
+
+    QList<QContact> contacts = m_manager->contacts(unionFilter);
+    if (contacts.empty()) {
+        callback(scId, "[]");
+    } else {
+        QStringList stringifiedContacts;
+        foreach (const QContact &contact, contacts) {
+            stringifiedContacts << jsonedContact(contact, fields);
+
+            if (!multiple)
+                break;
+        }
+        callback(scId, QString("[%1]").arg(stringifiedContacts.join(", ")));
+    }
+}
+
+QContactDetail::DetailType Contacts::cordovaFieldNameToQtDefinition(const QString &cordovaFieldName) const {
+    if (m_fieldNamePairs.contains(cordovaFieldName))
+        return m_fieldNamePairs[cordovaFieldName];
+
+    return QContactDetail::TypeUndefined;
+}
+
+int Contacts::subTypePhoneFromString(const QString &cordovaSubType) const
+{
+    QString preparedSubType = cordovaSubType.toLower();
+    if (preparedSubType == "mobile")
+        return QContactPhoneNumber::SubTypeMobile;
+    else if (preparedSubType == "fax")
+        return QContactPhoneNumber::SubTypeFax;
+    else if (preparedSubType == "pager")
+        return QContactPhoneNumber::SubTypePager;
+    else if (preparedSubType == "voice")
+        return QContactPhoneNumber::SubTypeVoice;
+    else if (preparedSubType == "modem")
+        return QContactPhoneNumber::SubTypeModem;
+    else if (preparedSubType == "video")
+        return QContactPhoneNumber::SubTypeVideo;
+    else if (preparedSubType == "car")
+        return QContactPhoneNumber::SubTypeCar;
+    else if (preparedSubType == "assistant")
+        return QContactPhoneNumber::SubTypeAssistant;
+    return QContactPhoneNumber::SubTypeLandline;
+}
+
+int Contacts::subTypeOnlineAccountFromString(const QString &cordovaSubType) const {
+    QString preparedSubType = cordovaSubType.toLower();
+    if (preparedSubType == "aim")
+        return QContactOnlineAccount::ProtocolAim;
+    else if (preparedSubType == "icq")
+        return QContactOnlineAccount::ProtocolIcq;
+    else if (preparedSubType == "irc")
+        return QContactOnlineAccount::ProtocolIrc;
+    else if (preparedSubType == "jabber")
+        return QContactOnlineAccount::ProtocolJabber;
+    else if (preparedSubType == "msn")
+        return QContactOnlineAccount::ProtocolMsn;
+    else if (preparedSubType == "qq")
+        return QContactOnlineAccount::ProtocolQq;
+    else if (preparedSubType == "skype")
+        return QContactOnlineAccount::ProtocolSkype;
+    else if (preparedSubType == "yahoo")
+        return QContactOnlineAccount::ProtocolYahoo;
+    return QContactOnlineAccount::ProtocolUnknown;
+}
+
+int Contacts::subTypeUrlFromString(const QString &cordovaSubType) const {
+    QString preparedSubType = cordovaSubType.toLower();
+    if (preparedSubType == "blog")
+        return QContactUrl::SubTypeBlog;
+    else if (preparedSubType == "favourite")
+        return QContactUrl::SubTypeFavourite;
+    return QContactUrl::SubTypeHomePage;
+}
+
+QString Contacts::subTypePhoneToString(int qtSubType) const {
+    if (qtSubType == QContactPhoneNumber::SubTypeMobile)
+        return "mobile";
+    else if (qtSubType == QContactPhoneNumber::SubTypeFax)
+        return "fax";
+    else if (qtSubType == QContactPhoneNumber::SubTypePager)
+        return "pager";
+    else if (qtSubType == QContactPhoneNumber::SubTypeVoice)
+        return "voice";
+    else if (qtSubType == QContactPhoneNumber::SubTypeModem)
+        return "modem";
+    else if (qtSubType == QContactPhoneNumber::SubTypeVideo)
+        return "video";
+    else if (qtSubType == QContactPhoneNumber::SubTypeCar)
+        return "car";
+    else if (qtSubType == QContactPhoneNumber::SubTypeAssistant)
+        return "assistant";
+    return "home";
+}
+
+QString Contacts::subTypeOnlineAccountToString(int qtSubType) const {
+    if (qtSubType == QContactOnlineAccount::ProtocolAim)
+        return "aim";
+    else if (qtSubType == QContactOnlineAccount::ProtocolIcq)
+        return "icq";
+    else if (qtSubType == QContactOnlineAccount::ProtocolIrc)
+        return "irc";
+    else if (qtSubType == QContactOnlineAccount::ProtocolJabber)
+        return "jabber";
+    else if (qtSubType == QContactOnlineAccount::ProtocolMsn)
+        return "msn";
+    else if (qtSubType == QContactOnlineAccount::ProtocolQq)
+        return "qq";
+    else if (qtSubType == QContactOnlineAccount::ProtocolSkype)
+        return "skype";
+    else if (qtSubType == QContactOnlineAccount::ProtocolYahoo)
+        return "yahoo";
+    return "unknown";
+}
+
+QString Contacts::subTypeUrlToString(int qtSubType) const {
+    if (qtSubType == QContactUrl::SubTypeBlog)
+        return "blog";
+    else if (qtSubType == QContactUrl::SubTypeFavourite)
+        return "favourite";
+    return "homepage";
+}
+
+QString Contacts::jsonedContact(const QContact &contact, const QStringList &fields) const {
+    QStringList resultingFields = fields;
+    if (resultingFields.empty())
+        resultingFields.append(m_fieldNamePairs.keys());
+    if (!resultingFields.contains("id"))
+        resultingFields << "id";
+    QStringList fieldValuesList;
+    foreach (const QString &field, resultingFields) {
+        QContactDetail::DetailType qtDefinitionName = cordovaFieldNameToQtDefinition(field);
+        if (field == "id") {
+            fieldValuesList << QString("%1: \"%2\"")
+                               .arg(field)
+                               .arg(contact.id().toString());
+        } else if (field == "displayName") {
+            QContactDisplayLabel detail = contact.detail(qtDefinitionName);
+            fieldValuesList << QString("%1: \"%2\"")
+                               .arg(field)
+                               .arg(detail.label());
+        } else if (field == "nickname") {
+            QContactNickname detail = contact.detail(qtDefinitionName);
+            fieldValuesList << QString("%1: \"%2\"")
+                               .arg(field)
+                               .arg(detail.nickname());
+        } else if (field == "note") {
+            QContactNote detail = contact.detail(qtDefinitionName);
+            fieldValuesList << QString("%1: \"%2\"")
+                               .arg(field)
+                               .arg(detail.note());
+        } else if (field == "phoneNumbers") {
+            QStringList fieldValues;
+            QList<QContactDetail> details = contact.details(qtDefinitionName);
+            foreach (const QContactDetail &detail, details) {
+                QContactPhoneNumber castedDetail = detail;
+                QStringList subTypes;
+                foreach (int subType, castedDetail.subTypes())
+                    subTypes << subTypePhoneToString(subType);
+
+                if (subTypes.isEmpty())
+                    subTypes << "phone";
+                foreach(const QString &subType, subTypes) {
+                    fieldValues << QString("{type: \"%1\", value: \"%2\", pref: %3}")
+                                   .arg(subType)
+                                   .arg(castedDetail.number())
+                                   .arg("false");
+                }
+            }
+            fieldValuesList << QString("%1: [%2]")
+                               .arg(field)
+                               .arg(fieldValues.join(", "));
+        } else if (field == "emails") {
+            QStringList fieldValues;
+            QList<QContactDetail> details = contact.details(qtDefinitionName);
+            foreach (const QContactDetail &detail, details) {
+                QContactEmailAddress castedDetail = detail;
+                fieldValues << QString("{type: \"%1\", value: \"%2\", pref: %3}")
+                               .arg("email")
+                               .arg(castedDetail.emailAddress())
+                               .arg("false");
+            }
+            fieldValuesList << QString("%1: [%2]")
+                               .arg(field)
+                               .arg(fieldValues.join(", "));
+        } else if (field == "ims") {
+            QStringList fieldValues;
+            QList<QContactDetail> details = contact.details(qtDefinitionName);
+            foreach (const QContactDetail &detail, details) {
+                QContactOnlineAccount castedDetail = detail;
+                QStringList subTypes;
+                foreach (int subType, castedDetail.subTypes())
+                    subTypes << subTypeOnlineAccountToString(subType);
+
+                if (subTypes.isEmpty())
+                    subTypes << "IM";
+                foreach(const QString &subType, subTypes) {
+                    fieldValues << QString("{type: \"%1\", value: \"%2\", pref: %3}")
+                                   .arg(subType)
+                                   .arg(castedDetail.accountUri())
+                                   .arg("false");
+                }
+            }
+            fieldValuesList << QString("%1: [%2]")
+                               .arg(field)
+                               .arg(fieldValues.join(", "));
+        } else if (field == "photos") {
+            QStringList fieldValues;
+            QList<QContactDetail> details = contact.details(qtDefinitionName);
+            foreach (const QContactDetail &detail, details) {
+                QContactAvatar castedDetail = detail;
+                fieldValues << QString("{type: \"%1\", value: \"%2\", pref: %3}")
+                               .arg("url")
+                               .arg(castedDetail.imageUrl().toString())
+                               .arg("false");
+            }
+            fieldValuesList << QString("%1: [%2]")
+                               .arg(field)
+                               .arg(fieldValues.join(", "));
+        } else if (field == "urls") {
+            QStringList fieldValues;
+            QList<QContactDetail> details = contact.details(qtDefinitionName);
+
+            foreach (const QContactDetail &detail, details) {
+                QContactUrl castedDetail = detail;
+                QString subType = subTypeUrlToString(castedDetail.subType());
+
+                fieldValues << QString("{type: \"%1\", value: \"%2\", pref: %3}")
+                               .arg(subType)
+                               .arg(castedDetail.url())
+                               .arg("false");
+            }
+            fieldValuesList << QString("%1: [%2]")
+                               .arg(field)
+                               .arg(fieldValues.join(", "));
+        } else if (field == "birthday") {
+            QContactBirthday detail = contact.detail(qtDefinitionName);
+            fieldValuesList << QString("%1: %2")
+                               .arg(field)
+                               .arg(detail.dateTime().toMSecsSinceEpoch());
+        } else if (field == "organizations") {
+            QStringList fieldValues;
+            QList<QContactDetail> details = contact.details(qtDefinitionName);
+            foreach (const QContactDetail &detail, details) {
+                QContactOrganization castedDetail = detail;
+                fieldValues << QString("{type: \"%1\", name: \"%2\", department: \"%3\", title: \"%4\", pref: %5}")
+                               .arg("organization")
+                               .arg(castedDetail.name())
+                               .arg(castedDetail.department().join(" "))
+                               .arg(castedDetail.role())
+                               .arg("false");
+            }
+            fieldValuesList << QString("%1: [%2]")
+                               .arg(field)
+                               .arg(fieldValues.join(", "));
+        } else if (field == "name") {
+            QContactName detail = contact.detail(qtDefinitionName);
+            fieldValuesList <<  QString("%1: {familyName: \"%2\", givenName: \"%3\", middleName: \"%4\", honorificPrefix: \"%5\", honorificSuffix: \"%6\"}")
+                                .arg(field)
+                                .arg(detail.lastName())
+                                .arg(detail.firstName())
+                                .arg(detail.middleName())
+                                .arg(detail.prefix())
+                                .arg(detail.suffix());
+        }
+
+
+    }
+
+    return QString("{%1}").arg(fieldValuesList.join(", "));
+}

km0App/node_modules/cordova-plugin-contacts/src/ubuntu/contacts.h

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+#ifndef CONTACTS_H_SSSSSSS
+#define CONTACTS_H_SSSSSSS
+
+#include <cplugin.h>
+
+#include <QtContacts>
+#include <QtCore>
+
+QTCONTACTS_USE_NAMESPACE
+
+class Contacts : public CPlugin {
+    Q_OBJECT
+public:
+    explicit Contacts(Cordova *cordova);
+
+    virtual const QString fullName() override {
+        return Contacts::fullID();
+    }
+
+    virtual const QString shortName() override {
+        return "Contacts";
+    }
+
+    static const QString fullID() {
+        return "Contacts";
+    }
+
+public slots:
+    void save(int scId, int ecId, const QVariantMap &params);
+    void remove(int scId, int ecId, const QString &localId);
+    void search(int scId, int ecId, const QStringList &fields, const QVariantMap &params);
+
+private:
+    void findContacts(int scId, int ecId, const QStringList &fields, const QString &filter, bool multiple);
+    QContactDetail::DetailType cordovaFieldNameToQtDefinition(const QString &cordovaFieldName) const;
+    int subTypePhoneFromString(const QString &cordovaSubType) const;
+    int subTypeOnlineAccountFromString(const QString &cordovaSubType) const;
+    int subTypeUrlFromString(const QString &cordovaSubType) const;
+    QString subTypePhoneToString(int qtSubType) const;
+    QString subTypeOnlineAccountToString(int qtSubType) const;
+    QString subTypeUrlToString(int qtSubType) const;
+    QString jsonedContact(const QContact &contact, const QStringList &fields = QStringList()) const;
+
+    QHash<QString, QContactDetail::DetailType> m_fieldNamePairs;
+    QSet<QString> m_notSupportedFields;
+    QSharedPointer<QContactManager> m_manager;
+};
+
+#endif

km0App/node_modules/cordova-plugin-contacts/src/windows/ContactProxy.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ * 
+ */
+
+/* global Windows, WinJS */
+
+var ContactField = require('./ContactField'),
+    ContactAddress = require('./ContactAddress'),
+    ContactOrganization = require('./ContactOrganization'),
+    ContactName = require('./ContactName'),
+    ContactError = require('./ContactError'),
+    Contact = require('./Contact');
+
+
+function convertToContact(windowsContact) {
+    var contact = new Contact();
+
+    // displayName & nickname
+    contact.displayName = windowsContact.displayName || windowsContact.name;
+    contact.nickname = windowsContact.name;
+    contact.id = windowsContact.id;
+
+    // name
+    // Additional fields like lastName, middleName etc. available on windows8.1/wp8.1 only
+    contact.name = new ContactName(
+        windowsContact.displayName || windowsContact.name,
+        windowsContact.lastName,
+        windowsContact.firstName || windowsContact.name,
+        windowsContact.middleName,
+        windowsContact.honorificNamePrefix || windowsContact.honorificPrefix,
+        windowsContact.honorificNameSuffix || windowsContact.honorificSuffix);
+
+    // phoneNumbers
+    contact.phoneNumbers = [];
+    var phoneSource = windowsContact.phoneNumbers || windowsContact.phones;
+    var i;
+    for (i = 0; i < phoneSource.size; i++) {
+        var rawPhone = phoneSource[i];
+        var phone = new ContactField(rawPhone.category || rawPhone.kind, rawPhone.value || rawPhone.number);
+        contact.phoneNumbers.push(phone);
+    }
+
+    // emails
+    contact.emails = [];
+    var emailSource = windowsContact.emails;
+    for (i = 0; i < emailSource.size; i++) {
+        var rawEmail = emailSource[i];
+        var email = new ContactField(rawEmail.category || rawEmail.kind, rawEmail.value || rawEmail.address);
+        contact.emails.push(email);
+    }
+
+    // addressres
+    contact.addresses = [];
+    var addressSource = windowsContact.locations || windowsContact.addresses;
+    for (i = 0; i < addressSource.size; i++) {
+        var rawAddress = addressSource[i];
+        var address = new ContactAddress(
+            null,
+            rawAddress.category || rawAddress.kind,
+            rawAddress.unstructuredAddress,
+            rawAddress.street || rawAddress.streetAddress,
+            rawAddress.city || rawAddress.locality,
+            rawAddress.region,
+            rawAddress.postalCode,
+            rawAddress.country);
+        contact.addresses.push(address);
+    }
+
+    // ims
+    contact.ims = [];
+    var imSource = windowsContact.instantMessages || windowsContact.connectedServiceAccounts;
+    for (i = 0; i < imSource.size; i++) {
+        var rawIm = imSource[i];
+        var im = new ContactField(rawIm.category || rawIm.serviceName, rawIm.userName || rawIm.id);
+        contact.ims.push(im);
+    }
+
+    // jobInfo field available on Windows 8.1/WP8.1 only
+    var jobInfo = windowsContact.jobInfo;
+    if (jobInfo) {
+        contact.organizations = [];
+        for (var j = 0; j < jobInfo.size; j++) {
+            var rawJob = jobInfo[i];
+            contact.organizations.push(new ContactOrganization(false, null,
+                rawJob.companyName, rawJob.department, rawJob.title));
+        }
+    }
+
+    // note field available on Windows 8.1/WP8.1 only
+    var contactNotes = windowsContact.notes;
+    if (contactNotes) {
+        contact.note = contactNotes;
+    }
+
+    // returned is a file, a blob url can be made 
+    var contactPhoto = windowsContact.thumbnail;
+    if (contactPhoto && contactPhoto.path) {
+        contact.photos = [new ContactField('url', URL.createObjectURL(contactPhoto) , false)];
+    }
+
+    return contact;
+}
+
+// Win API Contacts namespace
+var contactsNS = Windows.ApplicationModel.Contacts;
+
+function cdvContactToWindowsContact(contact) {
+    var result = new contactsNS.Contact();
+    
+    // name first
+    if (contact.name) {
+        result.displayNameOverride = contact.name.formatted;
+        result.firstName = contact.name.givenName;
+        result.middleName = contact.name.middleName;
+        result.lastName = contact.name.familyName;
+        result.honorificNamePrefix = contact.name.honorificPrefix;
+        result.honorificNameSuffix = contact.name.honorificSuffix;
+    }
+    
+    result.nickname = contact.nickname;
+    
+    // phone numbers
+    if (contact.phoneNumbers) {
+        contact.phoneNumbers.forEach(function(contactPhone) {
+            var resultPhone = new contactsNS.ContactPhone();
+            resultPhone.description = contactPhone.type;
+            resultPhone.number = contactPhone.value;
+            result.phones.push(resultPhone);
+        });
+    }
+    
+    // emails
+    if (contact.emails) {
+        contact.emails.forEach(function(contactEmail) {
+            var resultEmail = new contactsNS.ContactEmail();
+            resultEmail.description = contactEmail.type;
+            resultEmail.address = contactEmail.value;
+            result.emails.push(resultEmail);
+        });
+    }
+    
+    // Addresses
+    if (contact.addresses) {
+        contact.addresses.forEach(function(contactAddress) {
+            var address = new contactsNS.ContactAddress();
+            address.description = contactAddress.type;
+            address.streetAddress = contactAddress.streetAddress;
+            address.locality = contactAddress.locality;
+            address.region = contactAddress.region;
+            address.postalCode = contactAddress.postalCode;
+            address.country = contactAddress.country;
+            result.addresses.push(address);
+        });
+    }
+    
+    // IMs
+    if (contact.ims) {
+        contact.ims.forEach(function(contactIM) {
+            var acct = new contactsNS.ContactConnectedServiceAccount();
+            acct.serviceName = contactIM.type;
+            acct.id = contactIM.value;
+            result.connectedServiceAccounts.push(acct);
+        });
+    }
+    
+    // JobInfo 
+    if (contact.organizations) {
+        contact.organizations.forEach(function(contactOrg) {
+            var job = new contactsNS.ContactJobInfo();
+            job.companyName = contactOrg.name;
+            job.department = contactOrg.department;
+            job.description = contactOrg.type;
+            job.title = contactOrg.title;
+            result.jobInfo.push(job);
+        });
+    }
+    
+    result.notes = contact.note;
+    
+    if (contact.photos) {
+        var eligiblePhotos = contact.photos.filter(function(photo) { 
+            return typeof photo.value !== 'undefined';
+        });
+        if (eligiblePhotos.length > 0) {
+            var supportedPhoto = eligiblePhotos[0];
+            var path = supportedPhoto.value;
+            
+            try {
+                var streamRef;
+                if (/^([a-z][a-z0-9+\-.]*):\/\//i.test(path)) {
+                    streamRef = Windows.Storage.Streams.RandomAccessStreamReference.createFromUri(new Windows.Foundation.Uri(path));
+                } else {
+                    streamRef = Windows.Storage.Streams.RandomAccessStreamReference.createFromFile(path);
+                }
+                result.thumbnail = streamRef;
+            }
+            catch (e) {
+                // incompatible reference to the photo
+            }
+        }
+    }
+    
+    return result;
+}
+
+module.exports = {
+
+    pickContact: function (win, fail, args) {
+
+        // ContactPicker class works differently on Windows8/8.1 and Windows Phone 8.1
+        // so we need to detect when we are running on phone
+        var runningOnPhone = navigator.userAgent.indexOf('Windows Phone') !== -1;
+
+        var picker = new contactsNS.ContactPicker();
+        if (runningOnPhone) {
+            // TODO: Windows Phone 8.1 requires this specification. This should be noted in quirks
+            // See http://msdn.microsoft.com/en-us/library/windows/apps/windows.applicationmodel.contacts.contactpicker.desiredfieldswithcontactfieldtype.aspx for details
+            // Multiple ContactFieldType items, appended to array causes `Request not suported` error.
+            picker.desiredFieldsWithContactFieldType.append(Windows.ApplicationModel.Contacts.ContactFieldType.phoneNumber);
+        }
+
+        // pickContactAsync is available on Windows 8.1 or later, instead of
+        // pickSingleContactAsync, which is deprecated in Windows 8.1,
+        // so try to use newer method, if available.
+        // see http://msdn.microsoft.com/en-us/library/windows/apps/windows.applicationmodel.contacts.contactpicker.picksinglecontactasync.aspx
+
+        var pickRequest = picker.pickContactAsync ? picker.pickContactAsync() : picker.pickSingleContactAsync();
+        pickRequest.done(function (contact) {
+            // if contact was not picked
+            if (!contact) {
+                var cancelledError = new ContactError(ContactError.OPERATION_CANCELLED_ERROR);
+                cancelledError.message = "User did not pick a contact.";
+                fail(cancelledError);
+                return;
+            }
+            // If we are on desktop, just send em back
+            if (!runningOnPhone) {
+                win(convertToContact(contact));
+                return;
+            }
+            // On WP8.1 fields set in resulted Contact object depends on desiredFieldsWithContactFieldType property of contact picker
+            // so we retrieve full contact by its' Id
+            contactsNS.ContactManager.requestStoreAsync().done(function (contactStore) {
+                contactStore.getContactAsync(contact.id).done(function(con) {
+                    win(convertToContact(con));
+                }, function() {
+                    fail(new ContactError(ContactError.UNKNOWN_ERROR));
+                });
+            }, function () {
+                fail(new ContactError(ContactError.UNKNOWN_ERROR));
+            });
+        });
+    },
+
+    save: function (win, fail, args) {
+        if (typeof contactsNS.ContactList === 'undefined') {
+            // Not supported yet since WinJS API do not provide methods to manage contactStore
+            // On Windows Phone 8.1 this can be implemented using native class library 
+            // See Windows.Phone.PersonalInformation namespace
+            // http://msdn.microsoft.com/en-us/library/windows/apps/xaml/windows.phone.personalinformation.aspx
+    
+            //We don't need to create Error object here since it will be created at navigator.contacts.find() method
+            if (fail) {
+                fail(ContactError.NOT_SUPPORTED_ERROR);
+            }
+            return;
+        }
+        
+        var winContact = cdvContactToWindowsContact(args[0]);
+        
+        contactsNS.ContactManager.requestStoreAsync(contactsNS.ContactStoreAccessType.appContactsReadWrite).then(function(store) {
+                return store.findContactListsAsync().then(function(lists) {
+                        if (lists.length > 0) {
+                            return lists[0];    
+                        } else {
+                            return store.createContactListAsync('');
+                        }
+                    }, function(error) {
+                        return store.createContactListAsync('');
+                    });
+            }).then(function(list) {
+                return list.saveContactAsync(winContact);
+            }).done(function(result) {
+                win(convertToContact(winContact));
+            }, function(error) {
+                fail(error);
+            });
+    },
+    
+    remove: function(win, fail, args) {
+        if (typeof contactsNS.ContactList === 'undefined') {
+            // Not supported yet since WinJS API do not provide methods to manage contactStore
+            // On Windows Phone 8.1 this can be implemented using native class library 
+            // See Windows.Phone.PersonalInformation namespace
+            // http://msdn.microsoft.com/en-us/library/windows/apps/xaml/windows.phone.personalinformation.aspx
+    
+            //We don't need to create Error object here since it will be created at navigator.contacts.find() method
+            if (fail) {
+                fail(ContactError.NOT_SUPPORTED_ERROR);
+            }
+            return;
+        }
+        
+        // This is a complicated scenario because in Win10, there is a notion of 'app contacts' vs 'global contacts'.
+        // search() returns all global contacts, which are "aggregate contacts", so the IDs of contacts that Cordova
+        // creates never match the IDs of the contacts returned from search().
+        // In order to work around this, we need to:
+        //  - Get two Stores: one that is read-write to the app-contacts list, one which is read-only for global contacts  
+        //  - Read the app-local store to see if a contact with the passed-in ID matches
+        //  - Grab the global aggregate contact manager, then ask it for raw contacts (app-local ACM returns access denied)
+        //  - Find my app-list of contacts
+        //  - Enumerate the raw contacts and see if there is a raw contact whose parent list matches the app-list
+        //  - If so, remove the raw contact from the app-list
+        //  - If any of this fails, the operation fails
+        WinJS.Promise.join([contactsNS.ContactManager.requestStoreAsync(contactsNS.ContactStoreAccessType.appContactsReadWrite), 
+                            contactsNS.ContactManager.requestStoreAsync(contactsNS.ContactStoreAccessType.allContactsReadOnly)]).then(function(stores) {
+                var readOnlyStore = stores[1];
+                var writableStore = stores[0];
+                
+                var storeReader = writableStore.getContactReader();
+                return storeReader.readBatchAsync().then(function(batch) {
+                    if (batch.status !== contactsNS.ContactBatchStatus.success) {
+                        // Couldn't read contacts store
+                        throw new ContactError(ContactError.IO_ERROR);
+                    }
+                    
+                    var candidates = batch.contacts.filter(function(testContact) {
+                        return testContact.id === args[0];
+                    });
+                    
+                    if (candidates.length === 0) {
+                        // No matching contact from aggregate store
+                        throw new ContactError(ContactError.IO_ERROR);
+                    }
+                    
+                    return candidates[0];
+                }).then(function(contactToDelete) {
+                    return readOnlyStore.aggregateContactManager.findRawContactsAsync(contactToDelete);
+                }).then(function(rawContacts) {
+                    return writableStore.findContactListsAsync().then(function(lists) {
+                        var deleteList = null;
+                        var deleteContact = null;
+                        var matched = lists.some(function(list) {
+                            for (var i = 0; i < rawContacts.length; i++) {
+                                if (rawContacts[i].contactListId === list.id) {
+                                    deleteList = list;
+                                    deleteContact = rawContacts[i];
+                                    return true;
+                                }
+                            }
+                            return false;
+                        });
+                        
+                        if (!matched) {
+                            throw new ContactError(ContactError.IO_ERROR);
+                        }
+                        
+                        return deleteList.deleteContactAsync(deleteContact);
+                    });
+                });
+            }).done(function() {
+                win();
+            }, function(error) {
+                fail(error);
+            });
+    },
+
+    search: function (win, fail, options) {
+
+        // searchFields is not supported yet due to WP8.1 API limitations.
+        // findContactsAsync(String) method will attempt to match the name, email address, or phone number of a contact. 
+        // see http://msdn.microsoft.com/en-us/library/windows/apps/dn624861.aspx for details
+        var searchFields = options[0], // jshint ignore:line
+            searchOptions = options[1],
+            searchFilter = searchOptions.filter,
+            searchMultiple = searchOptions && searchOptions.multiple;
+
+        // Check if necessary API is available.
+        // If not available, we are running on desktop, which doesn't support searching for contacts
+        if (!(contactsNS.ContactManager && contactsNS.ContactManager.requestStoreAsync)) {
+            fail(new ContactError(ContactError.NOT_SUPPORTED_ERROR));
+            return;
+        }
+
+        // Retrieve contact store instance
+        var contactStoreRequest = contactsNS.ContactManager.requestStoreAsync();
+
+        // When contact store retrieved
+        contactStoreRequest.done(function (contactStore) {
+            // determine, which function we use depending on whether searchOptions.filter specified or not
+            var contactsRequest = searchFilter ? contactStore.findContactsAsync(searchFilter) : contactStore.findContactsAsync();
+            // request contacts and resolve either with success or error callback
+            contactsRequest.done(function (contacts) {
+                var result = [];
+                if (contacts.size !== 0) {
+                    // Depending on searchOptions we should return all contacts found or only first 
+                    var outputContactsArray = searchMultiple ? contacts : [contacts[0]];
+                    outputContactsArray.forEach(function (contact) {
+                        // Convert windows contacts to plugin's contact objects
+                        result.push(convertToContact(contact));
+                    });
+                }
+                win(result);
+            }, function() {
+                fail(new ContactError(ContactError.UNKNOWN_ERROR));
+            });
+        }, function() {
+            fail(new ContactError(ContactError.UNKNOWN_ERROR));
+        });
+    }
+};
+
+require("cordova/exec/proxy").add("Contacts", module.exports);

km0App/node_modules/cordova-plugin-contacts/src/windows8/ContactProxy.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ * 
+ */
+
+/* global Windows */
+
+var ContactField = require('./ContactField'),
+    ContactAddress = require('./ContactAddress'),
+    ContactName = require('./ContactName'),
+    Contact = require('./Contact');
+
+
+function convertToContact(windowsContact) {
+    var contact = new Contact();
+    var i;
+
+    // displayName & nickname
+    contact.displayName = windowsContact.name;
+    contact.nickname = windowsContact.name;
+
+    // name
+    contact.name = new ContactName(windowsContact.name);
+
+    // phoneNumbers
+    contact.phoneNumbers = [];
+    for (i = 0; i < windowsContact.phoneNumbers.size; i++) {
+        var phone = new ContactField(windowsContact.phoneNumbers[i].category, windowsContact.phoneNumbers[i].value);
+        contact.phoneNumbers.push(phone);
+    }
+
+    // emails
+    contact.emails = [];
+    for (i = 0; i < windowsContact.emails.size; i++) {
+        var email = new ContactField(windowsContact.emails[i].category, windowsContact.emails[i].value);
+        contact.emails.push(email);
+    }
+
+    // addressres
+    contact.addresses = [];
+    for (i = 0; i < windowsContact.locations.size; i++) {
+        var address = new ContactAddress(null, windowsContact.locations[i].category,
+            windowsContact.locations[i].unstructuredAddress, windowsContact.locations[i].street,
+            null, windowsContact.locations[i].region, windowsContact.locations[i].postalCode,
+            windowsContact.locations[i].country);
+        contact.addresses.push(address);
+    }
+
+    // ims
+    contact.ims = [];
+    for (i = 0; i < windowsContact.instantMessages.size; i++) {
+        var im = new ContactField(windowsContact.instantMessages[i].category, windowsContact.instantMessages[i].userName);
+        contact.ims.push(im);
+    }
+
+    return contact;
+}
+
+module.exports = {
+    pickContact: function(win, fail, args) {
+        var picker = new Windows.ApplicationModel.Contacts.ContactPicker();
+
+        function success(con) {
+            // if contact was not picked
+            if (!con) {
+                if (fail) {
+                    setTimeout(function() {
+                        fail(new Error("User did not pick a contact."));
+                    }, 0);
+                }
+                return;
+            }
+
+            // send em back
+            win(convertToContact(con));
+        }
+
+        picker.selectionMode = Windows.ApplicationModel.Contacts.ContactSelectionMode.contacts; // select entire contact
+
+        // pickContactAsync is available on Windows 8.1 or later, instead of
+        // pickSingleContactAsync, which is deprecated after Windows 8,
+        // so try to use newer method, if available.
+        // see http://msdn.microsoft.com/en-us/library/windows/apps/windows.applicationmodel.contacts.contactpicker.picksinglecontactasync.aspx
+        if (picker.pickContactAsync) {
+            // TODO: 8.1 has better contact support via the 'Contact' object
+        } else {
+            picker.pickSingleContactAsync().done(success, fail);
+        }
+    },
+
+    save:function(win,fail,args){
+        if (console && console.error) {
+            console.error("Error : Windows 8 does not support creating/saving contacts");
+        }
+        if (fail) {
+            setTimeout(function () {
+                fail(new Error("Contact create/save not supported on Windows 8"));
+            }, 0);
+        }
+    },
+
+    search: function(win, fail, args) {
+        if (console && console.error) {
+            console.error("Error : Windows 8 does not support searching contacts");
+        }
+        if (fail) {
+            setTimeout(function() {
+                fail(new Error("Contact search not supported on Windows 8"));
+            }, 0);
+        }
+    }
+};
+
+require("cordova/exec/proxy").add("Contacts", module.exports);

km0App/node_modules/cordova-plugin-contacts/src/wp/ContactPicker.xaml

+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<phone:PhoneApplicationPage
+    x:Class="WPCordovaClassLib.Cordova.Commands.ContactPicker"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
+    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
+    FontFamily="{StaticResource PhoneFontFamilyNormal}"
+    FontSize="{StaticResource PhoneFontSizeLarge}"
+    Foreground="{StaticResource PhoneForegroundBrush}"
+    SupportedOrientations="Portrait" Orientation="Portrait"
+    shell:SystemTray.IsVisible="False">
+
+    <Grid x:Name="ContentRoot" Background="Transparent">
+        
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto"></RowDefinition>
+            <RowDefinition Height="*"></RowDefinition>
+        </Grid.RowDefinitions>
+
+        <TextBlock Name="HeaderBlock"
+                   Text="CHOOSE A CONTACT" 
+                   Margin="20,50,0,50" 
+                   FontSize="{StaticResource PhoneFontSizeMedium}"
+                   FontFamily="{StaticResource PhoneFontFamilySemiBold}"
+                   Grid.Row="0"
+                   />
+
+        <TextBlock Name="NoContactsBlock"
+                   Margin="20,0,0,0" 
+                   Text="Sorry, we couldn't find any contacts."
+                   TextWrapping="Wrap"
+                   FontSize="{StaticResource PhoneFontSizeLarge}"
+                   FontFamily="{StaticResource PhoneFontFamilyLight}"
+                   Visibility="Collapsed"
+                   Grid.Row="1"
+                   />
+        
+        <phone:LongListSelector Name="lstContacts"
+                                SelectionChanged="ContactsListSelectionChanged"
+                                Grid.Row="1">
+            <phone:LongListSelector.ItemTemplate>
+                <DataTemplate>
+                    <StackPanel Orientation="Horizontal" Margin="16,0,0,0">
+                        <StackPanel Margin="0,20,0,10">
+                            <TextBlock Text="{Binding DisplayName}"
+                                       TextWrapping="Wrap"
+                                       Style="{StaticResource PhoneTextExtraLargeStyle}" />
+                        </StackPanel>
+                    </StackPanel>
+                </DataTemplate>
+            </phone:LongListSelector.ItemTemplate>
+        </phone:LongListSelector>
+        
+    </Grid>
+</phone:PhoneApplicationPage>

km0App/node_modules/cordova-plugin-contacts/src/wp/ContactPicker.xaml.cs

+/*
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+namespace WPCordovaClassLib.Cordova.Commands
+{
+    using System;
+    using System.Linq;
+    using System.Windows;
+    using System.Windows.Controls;
+    using System.Windows.Navigation;
+    using Microsoft.Phone.Tasks;
+    using Microsoft.Phone.UserData;
+    using DeviceContacts = Microsoft.Phone.UserData.Contacts;
+
+    /// <summary>
+    /// Custom implemented class for picking single contact
+    /// </summary>
+    public partial class ContactPicker
+    {
+        #region Fields
+
+        /// <summary>
+        /// Result of ContactPicker call, represent contact returned.
+        /// </summary>
+        private ContactPickerTask.PickResult result;
+
+        #endregion
+
+        #region Constructors
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ContactPicker"/> class. 
+        /// </summary>
+        public ContactPicker()
+        {
+            InitializeComponent();
+            var cons = new DeviceContacts();
+            cons.SearchCompleted += this.OnSearchCompleted;
+            cons.SearchAsync(string.Empty, FilterKind.None, string.Empty);
+        }
+
+        #endregion
+
+        #region Callbacks
+
+        /// <summary>
+        /// Occurs when contact is selected or pick operation cancelled.
+        /// </summary>
+        public event EventHandler<ContactPickerTask.PickResult> Completed;
+
+        #endregion
+
+        /// <summary>
+        /// The on navigated from.
+        /// </summary>
+        /// <param name="e">
+        /// The e.
+        /// </param>
+        protected override void OnNavigatedFrom(NavigationEventArgs e)
+        {
+            if (this.result == null)
+            {
+                this.Completed(this, new ContactPickerTask.PickResult(TaskResult.Cancel));
+            }
+
+            base.OnNavigatedFrom(e);
+        }
+
+        /// <summary>
+        /// Called when contacts retrieval completed.
+        /// </summary>
+        /// <param name="sender">The sender.</param>
+        /// <param name="e">The <see cref="ContactsSearchEventArgs"/> instance containing the event data.</param>
+        private void OnSearchCompleted(object sender, ContactsSearchEventArgs e)
+        {
+            if (e.Results.Count() != 0)
+            {
+                lstContacts.ItemsSource = e.Results.ToList();
+                lstContacts.Visibility = Visibility.Visible;
+                NoContactsBlock.Visibility = Visibility.Collapsed;
+            }
+            else
+            {
+                lstContacts.Visibility = Visibility.Collapsed;
+                NoContactsBlock.Visibility = Visibility.Visible;
+            }
+        }
+
+        /// <summary>
+        /// Called when any contact is selected.
+        /// </summary>
+        /// <param name="sender">
+        /// The sender.
+        /// </param>
+        /// <param name="e">
+        /// The e.
+        /// </param>
+        private void ContactsListSelectionChanged(object sender, SelectionChangedEventArgs e)
+        {
+            this.result = new ContactPickerTask.PickResult(TaskResult.OK) { Contact = e.AddedItems[0] as Contact };
+            this.Completed(this, this.result);
+
+            if (NavigationService.CanGoBack)
+            {
+                NavigationService.GoBack();
+            }
+        }
+    }
+}

km0App/node_modules/cordova-plugin-contacts/src/wp/ContactPickerTask.cs

+/*
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+namespace WPCordovaClassLib.Cordova.Commands
+{
+    using System;
+    using System.Windows;
+    using Microsoft.Phone.Controls;
+    using Microsoft.Phone.Tasks;
+    using Microsoft.Phone.UserData;
+
+    /// <summary>
+    /// Allows an application to pick contact. 
+    /// Use this to allow users to pick contact from your application.
+    /// </summary>
+    public class ContactPickerTask
+    {
+        /// <summary>
+        /// Occurs when a Pick task is completed.
+        /// </summary>
+        public event EventHandler<PickResult> Completed;
+
+        /// <summary>
+        /// Shows Contact pick application
+        /// </summary>
+        public void Show()
+        {
+            Deployment.Current.Dispatcher.BeginInvoke(() =>
+            {
+                var root = Application.Current.RootVisual as PhoneApplicationFrame;
+
+                string baseUrl = "/";
+
+                if (root != null)
+                {
+                    root.Navigated += this.OnNavigate;
+
+                    // dummy parameter is used to always open a fresh version
+                    root.Navigate(
+                        new Uri(
+                            baseUrl + "Plugins/cordova-plugin-contacts/ContactPicker.xaml?dummy="
+                            + Guid.NewGuid(),
+                            UriKind.Relative));
+                }
+            });
+        }
+
+        /// <summary>
+        /// Performs additional configuration of the picker application.
+        /// </summary>
+        /// <param name="sender">The source of the event.</param>
+        /// <param name="e">The <see cref="System.Windows.Navigation.NavigationEventArgs"/> instance containing the event data.</param>
+        private void OnNavigate(object sender, System.Windows.Navigation.NavigationEventArgs e)
+        {
+            if (!(e.Content is ContactPicker))
+            {
+                return;
+            }
+
+            var phoneApplicationFrame = Application.Current.RootVisual as PhoneApplicationFrame;
+            if (phoneApplicationFrame != null)
+            {
+                phoneApplicationFrame.Navigated -= this.OnNavigate;
+            }
+
+            ContactPicker contactPicker = (ContactPicker)e.Content;
+
+            if (contactPicker != null)
+            {
+                contactPicker.Completed += this.Completed;
+            }
+            else if (this.Completed != null)
+            {
+                this.Completed(this, new PickResult(TaskResult.Cancel));
+            }
+        }
+
+        /// <summary>
+        /// Represents contact returned
+        /// </summary>
+        public class PickResult : TaskEventArgs
+        {
+            /// <summary>
+            /// Initializes a new instance of the PickResult class.
+            /// </summary>
+            public PickResult()
+            {
+            }
+
+            /// <summary>
+            /// Initializes a new instance of the PickResult class
+            /// with the specified Microsoft.Phone.Tasks.TaskResult.
+            /// </summary>
+            /// <param name="taskResult">Associated Microsoft.Phone.Tasks.TaskResult</param>
+            public PickResult(TaskResult taskResult)
+                : base(taskResult)
+            {
+            }
+
+            /// <summary>
+            ///  Gets the contact.
+            /// </summary>
+            public Contact Contact { get; internal set; }
+        }
+    }
+}

km0App/node_modules/cordova-plugin-contacts/src/wp/Contacts.cs

+/*
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+using Microsoft.Phone.Tasks;
+using Microsoft.Phone.UserData;
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Globalization;
+using System.Linq;
+using System.Runtime.Serialization;
+using System.Windows;
+using DeviceContacts = Microsoft.Phone.UserData.Contacts;
+
+
+namespace WPCordovaClassLib.Cordova.Commands
+{
+    [DataContract]
+    public class SearchOptions
+    {
+        [DataMember]
+        public string filter { get; set; }
+
+        [DataMember]
+        public bool multiple { get; set; }
+
+        [DataMember]
+        public string[] desiredFields { get; set; }
+    }
+
+    [DataContract]
+    public class ContactSearchParams
+    {
+        [DataMember]
+        public string[] fields { get; set; }
+
+        [DataMember]
+        public SearchOptions options { get; set; }
+    }
+
+    [DataContract]
+    public class JSONContactAddress
+    {
+        [DataMember]
+        public string formatted { get; set; }
+
+        [DataMember]
+        public string type { get; set; }
+
+        [DataMember]
+        public string streetAddress { get; set; }
+
+        [DataMember]
+        public string locality { get; set; }
+
+        [DataMember]
+        public string region { get; set; }
+
+        [DataMember]
+        public string postalCode { get; set; }
+
+        [DataMember]
+        public string country { get; set; }
+
+        [DataMember]
+        public bool pref { get; set; }
+    }
+
+    [DataContract]
+    public class JSONContactName
+    {
+        [DataMember]
+        public string formatted { get; set; }
+
+        [DataMember]
+        public string familyName { get; set; }
+
+        [DataMember]
+        public string givenName { get; set; }
+
+        [DataMember]
+        public string middleName { get; set; }
+
+        [DataMember]
+        public string honorificPrefix { get; set; }
+
+        [DataMember]
+        public string honorificSuffix { get; set; }
+    }
+
+    [DataContract]
+    public class JSONContactField
+    {
+        [DataMember]
+        public string type { get; set; }
+
+        [DataMember]
+        public string value { get; set; }
+
+        [DataMember]
+        public bool pref { get; set; }
+    }
+
+    [DataContract]
+    public class JSONContactOrganization
+    {
+        [DataMember]
+        public string type { get; set; }
+
+        [DataMember]
+        public string name { get; set; }
+
+        [DataMember]
+        public bool pref { get; set; }
+
+        [DataMember]
+        public string department { get; set; }
+
+        [DataMember]
+        public string title { get; set; }
+    }
+
+    [DataContract]
+    public class JSONContact
+    {
+        [DataMember]
+        public string id { get; set; }
+
+        [DataMember]
+        public string rawId { get; set; }
+
+        [DataMember]
+        public string displayName { get; set; }
+
+        [DataMember]
+        public string nickname { get; set; }
+
+        [DataMember]
+        public string note { get; set; }
+
+        [DataMember]
+        public JSONContactName name { get; set; }
+
+        [DataMember]
+        public JSONContactField[] emails { get; set; }
+
+        [DataMember]
+        public JSONContactField[] phoneNumbers { get; set; }
+
+        [DataMember]
+        public JSONContactField[] ims { get; set; }
+
+        [DataMember]
+        public JSONContactField[] photos { get; set; }
+
+        [DataMember]
+        public JSONContactField[] categories { get; set; }
+
+        [DataMember]
+        public JSONContactField[] urls { get; set; }
+
+        [DataMember]
+        public JSONContactOrganization[] organizations { get; set; }
+
+        [DataMember]
+        public JSONContactAddress[] addresses { get; set; }
+    }
+
+
+    public class Contacts : BaseCommand
+    {
+        public const int UNKNOWN_ERROR = 0;
+        public const int INVALID_ARGUMENT_ERROR = 1;
+        public const int TIMEOUT_ERROR = 2;
+        public const int PENDING_OPERATION_ERROR = 3;
+        public const int IO_ERROR = 4;
+        public const int NOT_SUPPORTED_ERROR = 5;
+        public const int PERMISSION_DENIED_ERROR = 20;
+        public const int SYNTAX_ERR = 8;
+
+        // refer here for contact properties we can access: http://msdn.microsoft.com/en-us/library/microsoft.phone.tasks.savecontacttask_members%28v=VS.92%29.aspx
+        public void save(string jsonContact)
+        {
+            // jsonContact is actually an array of 1 {contact}
+            string[] args = JSON.JsonHelper.Deserialize<string[]>(jsonContact);
+
+
+            JSONContact contact = JSON.JsonHelper.Deserialize<JSONContact>(args[0]);
+
+            SaveContactTask contactTask = new SaveContactTask();
+
+            if (contact.nickname != null)
+            {
+                contactTask.Nickname = contact.nickname;
+            }
+            if (contact.urls != null && contact.urls.Length > 0)
+            {
+                contactTask.Website = contact.urls[0].value;
+            }
+            if (contact.note != null)
+            {
+                contactTask.Notes = contact.note;
+            }
+
+            #region contact.name
+
+            if (contact.name != null)
+            {
+                if (contact.name.givenName != null)
+                    contactTask.FirstName = contact.name.givenName;
+                if (contact.name.familyName != null)
+                    contactTask.LastName = contact.name.familyName;
+                if (contact.name.middleName != null)
+                    contactTask.MiddleName = contact.name.middleName;
+                if (contact.name.honorificSuffix != null)
+                    contactTask.Suffix = contact.name.honorificSuffix;
+                if (contact.name.honorificPrefix != null)
+                    contactTask.Title = contact.name.honorificPrefix;
+            }
+
+            #endregion
+
+            #region contact.org
+
+            if (contact.organizations != null && contact.organizations.Count() > 0)
+            {
+                contactTask.Company = contact.organizations[0].name;
+                contactTask.JobTitle = contact.organizations[0].title;
+            }
+
+            #endregion
+
+            #region contact.phoneNumbers
+
+            if (contact.phoneNumbers != null && contact.phoneNumbers.Length > 0)
+            {
+                foreach (JSONContactField field in contact.phoneNumbers)
+                {
+                    string fieldType = field.type.ToLower();
+                    if (fieldType == "work")
+                    {
+                        contactTask.WorkPhone = field.value;
+                    }
+                    else if (fieldType == "home")
+                    {
+                        contactTask.HomePhone = field.value;
+                    }
+                    else if (fieldType == "mobile")
+                    {
+                        contactTask.MobilePhone = field.value;
+                    }
+                }
+            }
+
+            #endregion
+
+            #region contact.emails
+
+            if (contact.emails != null && contact.emails.Length > 0)
+            {
+                // set up different email types if they are not explicitly defined
+                foreach (string type in new[] {"personal", "work", "other"})
+                {
+                    foreach (JSONContactField field in contact.emails)
+                    {
+                        if (field != null && String.IsNullOrEmpty(field.type))
+                        {
+                            field.type = type;
+                            break;
+                        }
+                    }
+                }
+
+                foreach (JSONContactField field in contact.emails)
+                {
+                    if (field != null)
+                    {
+                        if (field.type != null && field.type != "other")
+                        {
+                            string fieldType = field.type.ToLower();
+                            if (fieldType == "work")
+                            {
+                                contactTask.WorkEmail = field.value;
+                            }
+                            else if (fieldType == "home" || fieldType == "personal")
+                            {
+                                contactTask.PersonalEmail = field.value;
+                            }
+                        }
+                        else
+                        {
+                            contactTask.OtherEmail = field.value;
+                        }
+                    }
+                }
+            }
+
+            #endregion
+
+            if (contact.note != null && contact.note.Length > 0)
+            {
+                contactTask.Notes = contact.note;
+            }
+
+            #region contact.addresses
+
+            if (contact.addresses != null && contact.addresses.Length > 0)
+            {
+                foreach (JSONContactAddress address in contact.addresses)
+                {
+                    if (address.type == null)
+                    {
+                        address.type = "home"; // set a default
+                    }
+                    string fieldType = address.type.ToLower();
+                    if (fieldType == "work")
+                    {
+                        contactTask.WorkAddressCity = address.locality;
+                        contactTask.WorkAddressCountry = address.country;
+                        contactTask.WorkAddressState = address.region;
+                        contactTask.WorkAddressStreet = address.streetAddress;
+                        contactTask.WorkAddressZipCode = address.postalCode;
+                    }
+                    else if (fieldType == "home" || fieldType == "personal")
+                    {
+                        contactTask.HomeAddressCity = address.locality;
+                        contactTask.HomeAddressCountry = address.country;
+                        contactTask.HomeAddressState = address.region;
+                        contactTask.HomeAddressStreet = address.streetAddress;
+                        contactTask.HomeAddressZipCode = address.postalCode;
+                    }
+                    else
+                    {
+                        // no other address fields available ...
+                        Debug.WriteLine("Creating contact with unsupported address type :: " + address.type);
+                    }
+                }
+            }
+
+            #endregion
+
+            contactTask.Completed += ContactSaveTaskCompleted;
+            contactTask.Show();
+        }
+
+        private void ContactSaveTaskCompleted(object sender, SaveContactResult e)
+        {
+            SaveContactTask task = sender as SaveContactTask;
+
+            if (e.TaskResult == TaskResult.OK)
+            {
+                Deployment.Current.Dispatcher.BeginInvoke(() =>
+                    {
+                        var deviceContacts = new DeviceContacts();
+                        deviceContacts.SearchCompleted +=
+                            postAdd_SearchCompleted;
+
+                        if (task != null)
+                        {
+                            string displayName = String.Format("{0}{2}{1}", task.FirstName, task.LastName,
+                                                               String.IsNullOrEmpty(task.FirstName) ? "" : " ");
+
+                            deviceContacts.SearchAsync(displayName, FilterKind.DisplayName, task);
+                        }
+                    });
+            }
+            else if (e.TaskResult == TaskResult.Cancel)
+            {
+                DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Operation cancelled."));
+            }
+        }
+
+        private void postAdd_SearchCompleted(object sender, ContactsSearchEventArgs e)
+        {
+            if (e.Results.Any())
+            {
+                new List<Contact>();
+
+                int n = (from Contact contact in e.Results select contact.GetHashCode()).Max();
+                Contact newContact = (from Contact contact in e.Results
+                                      where contact.GetHashCode() == n
+                                      select contact).First();
+
+                DispatchCommandResult(new PluginResult(PluginResult.Status.OK, newContact.ToJson(null)));
+            }
+            else
+            {
+                DispatchCommandResult(new PluginResult(PluginResult.Status.NO_RESULT));
+            }
+        }
+
+
+        public void remove(string id)
+        {
+            // note id is wrapped in [] and always has exactly one string ...
+            DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "{\"code\":" + NOT_SUPPORTED_ERROR + "}"));
+        }
+
+        public void pickContact(string arguments)
+        {
+            string[] args = JSON.JsonHelper.Deserialize<string[]>(arguments);
+
+            // Use custom contact picker because WP8 api doesn't provide its' own
+            // contact picker, only PhoneNumberChooser or EmailAddressChooserTask 
+            var task = new ContactPickerTask();
+            var desiredFields = JSON.JsonHelper.Deserialize<string[]>(args[0]);
+
+            task.Completed += delegate(Object sender, ContactPickerTask.PickResult e)
+                {
+                    if (e.TaskResult == TaskResult.OK)
+                    {
+                        string strResult = e.Contact.ToJson(desiredFields);
+                        var result = new PluginResult(PluginResult.Status.OK)
+                            {
+                                Message = strResult
+                            };
+                        DispatchCommandResult(result);
+                    }
+                    if (e.TaskResult == TaskResult.Cancel)
+                    {
+                        DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Operation cancelled."));
+                    }
+                };
+
+            task.Show();
+        }
+
+        public void search(string searchCriteria)
+        {
+            string[] args = JSON.JsonHelper.Deserialize<string[]>(searchCriteria);
+
+            ContactSearchParams searchParams = new ContactSearchParams();
+            try
+            {
+                searchParams.fields = JSON.JsonHelper.Deserialize<string[]>(args[0]);
+                searchParams.options = JSON.JsonHelper.Deserialize<SearchOptions>(args[1]);
+            }
+            catch (Exception)
+            {
+                DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, INVALID_ARGUMENT_ERROR));
+                return;
+            }
+
+            if (searchParams.options == null)
+            {
+                searchParams.options = new SearchOptions();
+                searchParams.options.filter = "";
+                searchParams.options.multiple = true;
+            }
+            else if (searchParams.options.filter == null)
+            {
+                searchParams.options.filter = "";
+            }
+
+            DeviceContacts deviceContacts = new DeviceContacts();
+            deviceContacts.SearchCompleted += contacts_SearchCompleted;
+
+            // default is to search all fields
+            FilterKind filterKind = FilterKind.None;
+            // if only one field is specified, we will try the 3 available DeviceContact search filters
+            if (searchParams.fields.Count() == 1)
+            {
+                if (searchParams.fields.Contains("name"))
+                {
+                    filterKind = FilterKind.DisplayName;
+                }
+                else if (searchParams.fields.Contains("emails"))
+                {
+                    filterKind = FilterKind.EmailAddress;
+                }
+                else if (searchParams.fields.Contains("phoneNumbers"))
+                {
+                    filterKind = FilterKind.PhoneNumber;
+                }
+            }
+
+            try
+            {
+                deviceContacts.SearchAsync(searchParams.options.filter, filterKind, searchParams);
+            }
+            catch (Exception ex)
+            {
+                Debug.WriteLine("search contacts exception :: " + ex.Message);
+            }
+        }
+
+        private void contacts_SearchCompleted(object sender, ContactsSearchEventArgs e)
+        {
+            var searchParams = (ContactSearchParams) e.State;
+
+            List<Contact> foundContacts = null;
+            // used for comparing strings, ""  instantiates with InvariantCulture
+            CultureInfo culture = new CultureInfo("");
+            // make the search comparisons case insensitive.
+            CompareOptions compare_option = CompareOptions.IgnoreCase;
+
+            // if we have multiple search fields
+
+            if (!String.IsNullOrEmpty(searchParams.options.filter) && searchParams.fields.Count() > 1)
+            {
+                foundContacts = new List<Contact>();
+                if (searchParams.fields.Contains("emails"))
+                {
+                    foundContacts.AddRange(from Contact con in e.Results
+                                           from ContactEmailAddress a in con.EmailAddresses
+                                           where
+                                               culture.CompareInfo.IndexOf(a.EmailAddress, searchParams.options.filter,
+                                                                           compare_option) >= 0
+                                           select con);
+                }
+                if (searchParams.fields.Contains("displayName"))
+                {
+                    foundContacts.AddRange(from Contact con in e.Results
+                                           where
+                                               culture.CompareInfo.IndexOf(con.DisplayName, searchParams.options.filter,
+                                                                           compare_option) >= 0
+                                           select con);
+                }
+                if (searchParams.fields.Contains("name"))
+                {
+                    foundContacts.AddRange(
+                        from Contact con in e.Results
+                        where con.CompleteName != null && (
+                            (con.CompleteName.FirstName != null     && culture.CompareInfo.IndexOf(con.CompleteName.FirstName, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.LastName != null      && culture.CompareInfo.IndexOf(con.CompleteName.LastName, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.MiddleName != null    && culture.CompareInfo.IndexOf(con.CompleteName.MiddleName, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.Nickname != null      && culture.CompareInfo.IndexOf(con.CompleteName.Nickname, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.Suffix != null        && culture.CompareInfo.IndexOf(con.CompleteName.Suffix, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.Title != null         && culture.CompareInfo.IndexOf(con.CompleteName.Title, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.YomiFirstName != null && culture.CompareInfo.IndexOf(con.CompleteName.YomiFirstName, searchParams.options.filter, compare_option) >= 0) ||
+                            (con.CompleteName.YomiLastName != null  && culture.CompareInfo.IndexOf(con.CompleteName.YomiLastName, searchParams.options.filter, compare_option) >= 0))
+                        select con);
+                }
+                if (searchParams.fields.Contains("phoneNumbers"))
+                {
+                    foundContacts.AddRange(from Contact con in e.Results
+                                           from ContactPhoneNumber a in con.PhoneNumbers
+                                           where
+                                               culture.CompareInfo.IndexOf(a.PhoneNumber, searchParams.options.filter,
+                                                                           compare_option) >= 0
+                                           select con);
+                }
+                if (searchParams.fields.Contains("urls"))
+                {
+                    foundContacts.AddRange(from Contact con in e.Results
+                                           from string a in con.Websites
+                                           where
+                                               culture.CompareInfo.IndexOf(a, searchParams.options.filter,
+                                                                           compare_option) >= 0
+                                           select con);
+                }
+            }
+            else
+            {
+                foundContacts = new List<Contact>(e.Results);
+            }
+
+            string strResult = "";
+
+            IEnumerable<Contact> distinctContacts = foundContacts.Distinct();
+
+            foreach (Contact contact in distinctContacts)
+            {
+                strResult += contact.ToJson(searchParams.options.desiredFields) + ",";
+
+                if (!searchParams.options.multiple)
+                {
+                    break; // just return the first item
+                }
+            }
+            PluginResult result = new PluginResult(PluginResult.Status.OK);
+            result.Message = "[" + strResult.TrimEnd(',') + "]";
+            DispatchCommandResult(result);
+        }
+    }
+}

km0App/node_modules/cordova-plugin-contacts/src/wp/ContactsHelper.cs

+/*
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+namespace WPCordovaClassLib.Cordova.Commands
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Text;
+    using Microsoft.Phone.UserData;
+    using System.IO;
+
+    /// <summary>
+    /// Implements helper functionality to serialize contact to JSON string.
+    /// </summary>
+    internal static class ContactsHelper
+    {
+        /// <summary>
+        /// Converts Contact object to string representation
+        /// </summary>
+        /// <param name="contact">Contact object</param>
+        /// <param name="desiredFields">array of fields names</param>
+        /// <returns>JSON string</returns>
+        public static string ToJson(this Contact contact, string[] desiredFields)
+        {
+            var contactFieldsWithJsonVals = contact.PopulateContactDictionary();
+
+            // if desiredFields are not defined, use all avilable fields
+            if (desiredFields == null || desiredFields.Length == 0)
+            {
+                desiredFields = contactFieldsWithJsonVals.Keys.ToArray();
+            }
+
+            return FillResultWithFields(desiredFields, contactFieldsWithJsonVals);
+        }
+
+        /// <summary>
+        /// Returns JSON string with desired fields only.
+        /// </summary>
+        /// <param name="desiredFields">The desired fields.</param>
+        /// <param name="contactFieldsWithJsonVals">The contact fields with JSON values.</param>
+        /// <returns>JSON string</returns>
+        private static string FillResultWithFields(string[] desiredFields, Dictionary<string, Func<string>> contactFieldsWithJsonVals)
+        {
+            var result = new StringBuilder();
+            for (int i = 0; i < desiredFields.Count(); i++)
+            {
+                if (!contactFieldsWithJsonVals.ContainsKey(desiredFields[i]))
+                {
+                    continue;
+                }
+
+                result.Append(contactFieldsWithJsonVals[desiredFields[i]]());
+                if (i != desiredFields.Count() - 1)
+                {
+                    result.Append(",");
+                }
+            }
+
+            return "{" + result + "}";
+        }
+
+        /// <summary>
+        /// Populates the contact dictionary.
+        /// </summary>
+        /// <param name="contact">Contact, that converted to JSON</param>
+        /// <returns>JSON string with populated data</returns>
+        private static Dictionary<string, Func<string>> PopulateContactDictionary(this Contact contact)
+        {
+            var contactFieldsJsonValsDictionary = new Dictionary<string, Func<string>>(StringComparer.InvariantCultureIgnoreCase)
+                {
+                    { "id", () => string.Format("\"id\":\"{0}\"", contact.GetHashCode()) },
+                    { "displayName", () => string.Format("\"displayName\":\"{0}\"", EscapeJson(contact.DisplayName)) },
+                    {
+                        "nickname",
+                        () =>
+                        string.Format(
+                            "\"nickname\":\"{0}\"",
+                            EscapeJson(contact.CompleteName != null ? contact.CompleteName.Nickname : string.Empty))
+                    },
+                    { "phoneNumbers", () => string.Format("\"phoneNumbers\":[{0}]", FormatJsonPhoneNumbers(contact)) },
+                    { "emails", () => string.Format("\"emails\":[{0}]", FormatJsonEmails(contact)) },
+                    { "addresses", () => string.Format("\"addresses\":[{0}]", FormatJsonAddresses(contact)) },
+                    { "urls", () => string.Format("\"urls\":[{0}]", FormatJsonWebsites(contact)) },
+                    { "photos", () => string.Format("\"photos\":[{0}]", FormatJsonPhotos(contact)) },
+                    { "name", () => string.Format("\"name\":{0}", FormatJsonName(contact)) },
+                    { "note", () => string.Format("\"note\":\"{0}\"", EscapeJson(contact.Notes.FirstOrDefault())) },
+                    {
+                        "birthday",
+                        () =>
+                        string.Format(
+                            "\"birthday\":\"{0}\"",
+                            EscapeJson(Convert.ToString(contact.Birthdays.FirstOrDefault())))
+                    }
+                };
+            return contactFieldsJsonValsDictionary;
+        }
+
+        /// <summary>
+        /// Add escape characters to the JSON string.
+        /// </summary>
+        /// <param name="str">Input JSON formatted string</param>
+        /// <returns>Escaped JSON string</returns>
+        private static string EscapeJson(string str)
+        {
+            if (string.IsNullOrEmpty(str))
+            {
+                return str;
+            }
+
+            return str.Replace("\n", "\\n")
+                      .Replace("\r", "\\r")
+                      .Replace("\t", "\\t")
+                      .Replace("\"", "\\\"")
+                      .Replace("&", "\\&");
+        }
+
+        /// <summary>
+        /// Formats phone numbers to JSON string.
+        /// </summary>
+        /// <param name="con">Contact object</param>
+        /// <returns>JSON string</returns>
+        private static string FormatJsonPhoneNumbers(Contact con)
+        {
+            string retVal = string.Empty;
+            const string ContactFieldFormat = "\"type\":\"{0}\",\"value\":\"{1}\",\"pref\":\"false\"";
+            foreach (ContactPhoneNumber number in con.PhoneNumbers)
+            {
+                string contactField = string.Format(ContactFieldFormat, number.Kind.ToString(), number.PhoneNumber);
+                retVal += "{" + contactField + "},";
+            }
+
+            return retVal.TrimEnd(',');
+        }
+
+        /*
+         *  formatted: The complete name of the contact. (DOMString)
+            familyName: The contacts family name. (DOMString)
+            givenName: The contacts given name. (DOMString)
+            middleName: The contacts middle name. (DOMString)
+            honorificPrefix: The contacts prefix (example Mr. or Dr.) (DOMString)
+            honorificSuffix: The contacts suffix (example Esq.). (DOMString)
+         */
+
+        /// <summary>
+        /// Formats the name to JSON string.
+        /// </summary>
+        /// <param name="con">Contact object</param>
+        /// <returns>JSON string</returns>
+        private static string FormatJsonName(Contact con)
+        {
+            string retVal;
+            const string FormatStr = "\"formatted\":\"{0}\"," +
+                               "\"familyName\":\"{1}\"," +
+                               "\"givenName\":\"{2}\"," +
+                               "\"middleName\":\"{3}\"," +
+                               "\"honorificPrefix\":\"{4}\"," +
+                               "\"honorificSuffix\":\"{5}\"";
+
+            if (con.CompleteName != null)
+            {
+                retVal = string.Format(
+                    FormatStr,
+                    EscapeJson(con.CompleteName.FirstName + " " + con.CompleteName.LastName),
+                    //// TODO: does this need suffix? middlename?
+                    EscapeJson(con.CompleteName.LastName),
+                    EscapeJson(con.CompleteName.FirstName),
+                    EscapeJson(con.CompleteName.MiddleName),
+                    EscapeJson(con.CompleteName.Title),
+                    EscapeJson(con.CompleteName.Suffix));
+            }
+            else
+            {
+                retVal = string.Format(FormatStr, "", "", "", "", "", "");
+            }
+
+            return "{" + retVal + "}";
+        }
+
+        /// <summary>
+        /// Format Emails to JSON string.
+        /// </summary>
+        /// <param name="con">Contact object</param>
+        /// <returns>JSON string</returns>
+        private static string FormatJsonEmails(Contact con)
+        {
+            string retVal = string.Empty;
+            const string ContactFieldFormat = "\"type\":\"{0}\",\"value\":\"{1}\",\"pref\":\"false\"";
+            foreach (ContactEmailAddress address in con.EmailAddresses)
+            {
+                string contactField = string.Format(
+                    ContactFieldFormat,
+                    address.Kind.ToString(),
+                    EscapeJson(address.EmailAddress));
+
+                retVal += "{" + contactField + "},";
+            }
+
+            return retVal.TrimEnd(',');
+        }
+
+        /// <summary>
+        /// Format Addresses to JSON string.
+        /// </summary>
+        /// <param name="con">Contact object</param>
+        /// <returns>JSON string</returns>
+        private static string FormatJsonAddresses(Contact con)
+        {
+            string retVal = string.Empty;
+            foreach (ContactAddress address in con.Addresses)
+            {
+                retVal += GetFormattedJsonAddress(address, false) + ",";
+            }
+
+            return retVal.TrimEnd(',');
+        }
+
+        /// <summary>
+        /// Format Websites to JSON string.
+        /// </summary>
+        /// <param name="con">Contact object</param>
+        /// <returns>JSON string</returns>
+        private static string FormatJsonWebsites(Contact con)
+        {
+            string retVal = string.Empty;
+            foreach (string website in con.Websites)
+            {
+                retVal += "\"" + EscapeJson(website) + "\",";
+            }
+
+            return retVal.TrimEnd(',');
+        }
+
+        /// <summary>
+        /// Format single address to JSON string.
+        /// </summary>
+        /// <param name="address">
+        /// Contact address.
+        /// </param>
+        /// <param name="isPrefered">
+        /// Contact is preferred?
+        /// </param>
+        /// <returns>
+        /// JSON string
+        /// </returns>
+        private static string GetFormattedJsonAddress(ContactAddress address, bool isPrefered)
+        {
+            const string AddressFormatString = "\"pref\":{0}," + // bool
+                                         "\"type\":\"{1}\"," +
+                                         "\"formatted\":\"{2}\"," +
+                                         "\"streetAddress\":\"{3}\"," +
+                                         "\"locality\":\"{4}\"," +
+                                         "\"region\":\"{5}\"," +
+                                         "\"postalCode\":\"{6}\"," +
+                                         "\"country\":\"{7}\"";
+
+            string formattedAddress = EscapeJson(address.PhysicalAddress.AddressLine1 + " "
+                + address.PhysicalAddress.AddressLine2 + " "
+                + address.PhysicalAddress.City + " "
+                + address.PhysicalAddress.StateProvince + " "
+                + address.PhysicalAddress.CountryRegion + " "
+                + address.PhysicalAddress.PostalCode);
+
+            string jsonAddress = string.Format(
+                AddressFormatString,
+                isPrefered ? "\"true\"" : "\"false\"",
+                address.Kind.ToString(),
+                formattedAddress,
+                EscapeJson(address.PhysicalAddress.AddressLine1 + " " + address.PhysicalAddress.AddressLine2),
+                address.PhysicalAddress.City,
+                address.PhysicalAddress.StateProvince,
+                address.PhysicalAddress.PostalCode,
+                address.PhysicalAddress.CountryRegion);
+
+            return "{" + jsonAddress + "}";
+        }
+
+        /// <summary>
+        /// Formats contact photos to JSON string.
+        /// </summary>
+        /// <param name="con">Contact object</param>
+        /// <returns>JSON string</returns>
+        private static string FormatJsonPhotos(Contact con) {
+
+            // we return single photo since contact object instance contains single picture only
+            var photoStream = con.GetPicture();
+ 
+            if (photoStream == null) {
+                return "";
+            }
+
+            return String.Format("{{value:\"{0}\", type: \"data\", pref: false}}", GetImageContent(photoStream));
+        }
+
+        /// <summary>
+        /// Returns image content in a form of base64 string
+        /// </summary>
+        /// <param name="stream">Image stream</param>
+        /// <returns>Base64 representation of the image</returns>
+        private static string GetImageContent(Stream stream)
+        {
+            byte[] imageContent = null;
+
+            try
+            {
+                int streamLength = (int)stream.Length;
+                imageContent = new byte[streamLength + 1];
+                stream.Read(imageContent, 0, streamLength);
+
+            }
+            finally
+            {
+                stream.Dispose();
+            }
+
+            return Convert.ToBase64String(imageContent);
+        }
+    }
+}

km0App/node_modules/cordova-plugin-contacts/tests/package.json

+{
+  "name": "cordova-plugin-contacts-tests",
+  "version": "2.3.1-dev",
+  "description": "",
+  "cordova": {
+    "id": "cordova-plugin-contacts-tests",
+    "platforms": []
+  },
+  "keywords": [
+    "ecosystem:cordova"
+  ],
+  "author": "",
+  "license": "Apache 2.0"
+}

km0App/node_modules/cordova-plugin-contacts/tests/plugin.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+    xmlns:rim="http://www.blackberry.com/ns/widgets"
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    id="cordova-plugin-contacts-tests"
+    version="3.0.1">
+    <name>Cordova Contacts Plugin Tests</name>
+    <license>Apache 2.0</license>
+
+    <js-module src="tests.js" name="tests">
+    </js-module>
+</plugin>

km0App/node_modules/cordova-plugin-contacts/types/index.d.ts

+// Type definitions for Apache Cordova Contacts plugin
+// Project: https://github.com/apache/cordova-plugin-contacts
+// Definitions by: Microsoft Open Technologies Inc <http://msopentech.com>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+//
+// Copyright (c) Microsoft Open Technologies, Inc.
+// Licensed under the MIT license.
+
+interface Navigator {
+    /** Provides access to the device contacts database. */
+    contacts: Contacts;
+}
+
+interface Contacts {
+    /**
+     * The navigator.contacts.create method is synchronous, and returns a new Contact object.
+     * This method does not retain the Contact object in the device contacts database,
+     * for which you need to invoke the Contact.save method.
+     * @param  properties Object with contact fields
+     */
+    create(properties?: ContactProperties): Contact;
+    /**
+     * The navigator.contacts.find method executes asynchronously, querying the device contacts database
+     * and returning an array of Contact objects. The resulting objects are passed to the onSuccess
+     * callback function specified by the onSuccess parameter.
+     * @param fields The fields parameter specifies the fields to be used as a search qualifier,
+     * and only those results are passed to the onSuccess callback function. A zero-length fields parameter
+     * is invalid and results in ContactError.INVALID_ARGUMENT_ERROR. A contactFields value of "*" returns all contact fields.
+     * @param onSuccess Success callback function invoked with the array of Contact objects returned from the database
+     * @param onError Error callback function, invoked when an error occurs.
+     * @param options Search options to filter navigator.contacts.
+     */
+    find(fields: string[],
+        onSuccess: (contacts: Contact[]) => void,
+        onError?: (error: ContactError) => void,
+        options?: ContactFindOptions): void;
+    /**
+     * The navigator.contacts.pickContact method launches the Contact Picker to select a single contact.
+     * The resulting object is passed to the contactSuccess callback function specified by the contactSuccess parameter.
+     * @param onSuccess Success callback function invoked with the array of Contact objects returned from the database
+     * @param onError Error callback function, invoked when an error occurs.
+     */
+    pickContact(onSuccess: (contact: Contact) => void,
+        onError: (error: ContactError) => void): void
+
+    /**
+     * This allows us to use an enumeration when setting the desired fields for the ContactFindOptions.
+     * The values will correspond to the type of string literals in ContactFieldType.
+     */
+    fieldType: {
+        addresses: "addresses",
+        birthday: "birthday",
+        categories: "categories",
+        country: "country",
+        department: "department",
+        displayName: "displayName",
+        emails: "emails",
+        familyName: "familyName",
+        formatted: "formatted",
+        givenName: "givenName",
+        honorificPrefix: "honorificPrefix",
+        honorificSuffix: "honorificSuffix",
+        id: "id",
+        ims: "ims",
+        locality: "locality",
+        middleName: "middleName",
+        name: "name",
+        nickname: "nickname",
+        note: "note",
+        organizations: "organizations",
+        phoneNumbers: "phoneNumbers",
+        photos: "photos",
+        postalCode: "postalCode",
+        region: "region",
+        streetAddress: "streetAddress",
+        title: "title",
+        urls: "urls"
+    }
+}
+
+interface ContactProperties {
+    /** A globally unique identifier. */
+    id?: string;
+    /** The name of this Contact, suitable for display to end users. */
+    displayName?: string;
+    /** An object containing all components of a persons name. */
+    name?: ContactName;
+    /** A casual name by which to address the contact. */
+    nickname?: string;
+    /** An array of all the contact's phone numbers. */
+    phoneNumbers?: ContactField[];
+    /** An array of all the contact's email addresses. */
+    emails?: ContactField[];
+    /** An array of all the contact's addresses. */
+    addresses?: ContactAddress[];
+    /** An array of all the contact's IM addresses. */
+    ims?: ContactField[];
+    /** An array of all the contact's organizations. */
+    organizations?: ContactOrganization[];
+    /** The birthday of the contact. */
+    birthday?: Date;
+    /** A note about the contact. */
+    note?: string;
+    /** An array of the contact's photos. */
+    photos?: ContactField[];
+    /** An array of all the user-defined categories associated with the contact. */
+    categories?: ContactField[];
+    /** An array of web pages associated with the contact. */
+    urls?: ContactField[];
+}
+
+/**
+ * The Contact object represents a user's contact. Contacts can be created, stored, or removed
+ * from the device contacts database. Contacts can also be retrieved (individually or in bulk)
+ * from the database by invoking the navigator.contacts.find method.
+ */
+interface Contact extends ContactProperties {
+    /**
+     * Returns a new Contact object that is a deep copy of the calling object, with the id property set to null
+     */
+    clone(): Contact;
+    /**
+     * Removes the contact from the device contacts database, otherwise executes an error callback with a ContactError object.
+     * @param onSuccess Success callback function invoked on success operation.
+     * @param onError Error callback function, invoked when an error occurs.
+     */
+    remove(
+        onSuccess: () => void,
+        onError: (error: Error) => void): void;
+    /**
+     * Saves a new contact to the device contacts database, or updates an existing contact if a contact with the same id already exists.
+     * @param onSuccess Success callback function invoked on success operation with che Contact object.
+     * @param onError Error callback function, invoked when an error occurs.
+     */
+    save(
+        onSuccess: (contact: Contact) => void,
+        onError: (error: Error) => void): void;
+}
+
+declare var Contact: {
+    /** Constructor of Contact object */
+    new (id?: string,
+        displayName?: string,
+        name?: ContactName,
+        nickname?: string,
+        phoneNumbers?: ContactField[],
+        emails?: ContactField[],
+        addresses?: ContactAddress[],
+        ims?: ContactField[],
+        organizations?: ContactOrganization[],
+        birthday?: Date,
+        note?: string,
+        photos?: ContactField[],
+        categories?: ContactField,
+        urls?: ContactField[]): Contact
+};
+
+/** The ContactError object is returned to the user through the contactError callback function when an error occurs. */
+interface ContactError {
+    /** Error code */
+    code: number;
+    /** Error message */
+    message: string;
+}
+
+declare var ContactError: {
+    new (code: number): ContactError;
+    UNKNOWN_ERROR: number;
+    INVALID_ARGUMENT_ERROR: number;
+    TIMEOUT_ERROR: number;
+    PENDING_OPERATION_ERROR: number;
+    IO_ERROR: number;
+    NOT_SUPPORTED_ERROR: number;
+    PERMISSION_DENIED_ERROR: number
+};
+
+/** Contains different kinds of information about a Contact object's name. */
+interface ContactName {
+    /** The complete name of the contact. */
+    formatted?: string;
+    /** The contact's family name. */
+    familyName?: string;
+    /** The contact's given name. */
+    givenName?: string;
+    /** The contact's middle name. */
+    middleName?: string;
+    /** The contact's prefix (example Mr. or Dr.) */
+    honorificPrefix?: string;
+    /** The contact's suffix (example Esq.). */
+    honorificSuffix?: string;
+}
+
+declare var ContactName: {
+    /** Constructor for ContactName object */
+    new (formatted?: string,
+        familyName?: string,
+        givenName?: string,
+        middleName?: string,
+        honorificPrefix?: string,
+        honorificSuffix?: string): ContactName
+};
+
+/**
+ * The ContactField object is a reusable component that represents contact fields generically.
+ * Each ContactField object contains a value, type, and pref property. A Contact object stores
+ * several properties in ContactField[] arrays, such as phone numbers and email addresses.
+ *
+ * In most instances, there are no pre-determined values for a ContactField object's type attribute.
+ * For example, a phone number can specify type values of home, work, mobile, iPhone,
+ * or any other value that is supported by a particular device platform's contact database.
+ * However, for the Contact photos field, the type field indicates the format of the returned image:
+ * url when the value attribute contains a URL to the photo image, or base64 when the value
+ * contains a base64-encoded image string.
+ */
+interface ContactField {
+    /** A string that indicates what type of field this is, home for example. */
+    type: string;
+    /** The value of the field, such as a phone number or email address. */
+    value: string;
+    /** Set to true if this ContactField contains the user's preferred value. */
+    pref: boolean;
+}
+
+declare var ContactField: {
+    /** Constructor for ContactField object */
+    new (type?: string,
+        value?: string,
+        pref?: boolean): ContactField
+};
+
+/**
+ * The ContactAddress object stores the properties of a single address of a contact.
+ * A Contact object may include more than one address in a ContactAddress[] array.
+ */
+interface ContactAddress {
+    /** Set to true if this ContactAddress contains the user's preferred value. */
+    pref?: boolean;
+    /** A string indicating what type of field this is, home for example. */
+    type?: string;
+    /** The full address formatted for display. */
+    formatted?: string;
+    /** The full street address. */
+    streetAddress?: string;
+    /** The city or locality. */
+    locality?: string;
+    /** The state or region. */
+    region?: string;
+    /** The zip code or postal code. */
+    postalCode?: string;
+    /** The country name. */
+    country?: string;
+}
+
+declare var ContactAddress: {
+    /** Constructor of ContactAddress object */
+    new (pref?: boolean,
+        type?: string,
+        formatted?: string,
+        streetAddress?: string,
+        locality?: string,
+        region?: string,
+        postalCode?: string,
+        country?: string): ContactAddress
+};
+
+/**
+ * The ContactOrganization object stores a contact's organization properties. A Contact object stores
+ * one or more ContactOrganization objects in an array.
+ */
+interface ContactOrganization {
+    /** Set to true if this ContactOrganization contains the user's preferred value. */
+    pref?: boolean;
+    /** A string that indicates what type of field this is, home for example. */
+    type?: string;
+    /** The name of the organization. */
+    name?: string;
+    /** The department the contract works for. */
+    department?: string;
+    /** The contact's title at the organization. */
+    title?: string;
+}
+
+declare var ContactOrganization: {
+    /** Constructor for ContactOrganization object */
+    new (pref?: boolean,
+        type?: string,
+        name?: string,
+        department?: string,
+        title?: string): ContactOrganization
+};
+
+/** Search options to filter navigator.contacts.  */
+interface ContactFindOptions {
+    /** The search string used to find navigator.contacts. */
+    filter?: string;
+    /** Determines if the find operation returns multiple navigator.contacts. */
+    multiple?: boolean;
+    /* Contact fields to be returned back. If specified, the resulting Contact object only features values for these fields. */
+    desiredFields?: ContactFieldType[];
+}
+
+/** these are the string values that are valid for the desired fields in ContactFindOptions */
+declare type ContactFieldType =
+    "addresses"
+    | "birthday"
+    | "categories"
+    | "country"
+    | "department"
+    | "displayName"
+    | "emails"
+    | "familyName"
+    | "formatted"
+    | "givenName"
+    | "honorificPrefix"
+    | "honorificSuffix"
+    | "id"
+    | "ims"
+    | "locality"
+    | "middleName"
+    | "name"
+    | "nickname"
+    | "note"
+    | "organizations"
+    | "phoneNumbers"
+    | "photos"
+    | "postalCode"
+    | "region"
+    | "streetAddress"
+    | "title"
+    | "urls";
+
+declare var ContactFindOptions: {
+    /** Constructor for ContactFindOptions object */
+    new (filter?: string,
+        multiple?: boolean,
+        desiredFields?: ContactFieldType[]): ContactFindOptions
+};

km0App/node_modules/cordova-plugin-contacts/www/Contact.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+var argscheck = require('cordova/argscheck'),
+    exec = require('cordova/exec'),
+    ContactError = require('./ContactError'),
+    utils = require('cordova/utils'),
+    convertUtils = require('./convertUtils');
+
+/**
+* Contains information about a single contact.
+* @constructor
+* @param {DOMString} id unique identifier
+* @param {DOMString} displayName
+* @param {ContactName} name
+* @param {DOMString} nickname
+* @param {Array.<ContactField>} phoneNumbers array of phone numbers
+* @param {Array.<ContactField>} emails array of email addresses
+* @param {Array.<ContactAddress>} addresses array of addresses
+* @param {Array.<ContactField>} ims instant messaging user ids
+* @param {Array.<ContactOrganization>} organizations
+* @param {DOMString} birthday contact's birthday
+* @param {DOMString} note user notes about contact
+* @param {Array.<ContactField>} photos
+* @param {Array.<ContactField>} categories
+* @param {Array.<ContactField>} urls contact's web sites
+*/
+var Contact = function (id, displayName, name, nickname, phoneNumbers, emails, addresses,
+    ims, organizations, birthday, note, photos, categories, urls) {
+    this.id = id || null;
+    this.rawId = null;
+    this.displayName = displayName || null;
+    this.name = name || null; // ContactName
+    this.nickname = nickname || null;
+    this.phoneNumbers = phoneNumbers || null; // ContactField[]
+    this.emails = emails || null; // ContactField[]
+    this.addresses = addresses || null; // ContactAddress[]
+    this.ims = ims || null; // ContactField[]
+    this.organizations = organizations || null; // ContactOrganization[]
+    this.birthday = birthday || null;
+    this.note = note || null;
+    this.photos = photos || null; // ContactField[]
+    this.categories = categories || null; // ContactField[]
+    this.urls = urls || null; // ContactField[]
+};
+
+/**
+* Removes contact from device storage.
+* @param successCB success callback
+* @param errorCB error callback
+*/
+Contact.prototype.remove = function(successCB, errorCB) {
+    argscheck.checkArgs('FF', 'Contact.remove', arguments);
+    var fail = errorCB && function(code) {
+        errorCB(new ContactError(code));
+    };
+    if (this.id === null) {
+        fail(ContactError.UNKNOWN_ERROR);
+    }
+    else {
+        exec(successCB, fail, "Contacts", "remove", [this.id]);
+    }
+};
+
+/**
+* Creates a deep copy of this Contact.
+* With the contact ID set to null.
+* @return copy of this Contact
+*/
+Contact.prototype.clone = function() {
+    var clonedContact = utils.clone(this);
+    clonedContact.id = null;
+    clonedContact.rawId = null;
+
+    function nullIds(arr) {
+        if (arr) {
+            for (var i = 0; i < arr.length; ++i) {
+                arr[i].id = null;
+            }
+        }
+    }
+
+    // Loop through and clear out any id's in phones, emails, etc.
+    nullIds(clonedContact.phoneNumbers);
+    nullIds(clonedContact.emails);
+    nullIds(clonedContact.addresses);
+    nullIds(clonedContact.ims);
+    nullIds(clonedContact.organizations);
+    nullIds(clonedContact.categories);
+    nullIds(clonedContact.photos);
+    nullIds(clonedContact.urls);
+    return clonedContact;
+};
+
+/**
+* Persists contact to device storage.
+* @param successCB success callback
+* @param errorCB error callback
+*/
+Contact.prototype.save = function(successCB, errorCB) {
+    argscheck.checkArgs('FFO', 'Contact.save', arguments);
+    var fail = errorCB && function(code) {
+        errorCB(new ContactError(code));
+    };
+    var success = function(result) {
+        if (result) {
+            if (successCB) {
+                var fullContact = require('./contacts').create(result);
+                successCB(convertUtils.toCordovaFormat(fullContact));
+            }
+        }
+        else {
+            // no Entry object returned
+            fail(ContactError.UNKNOWN_ERROR);
+        }
+    };
+    var dupContact = convertUtils.toNativeFormat(utils.clone(this));
+    exec(success, fail, "Contacts", "save", [dupContact]);
+};
+
+
+module.exports = Contact;

km0App/node_modules/cordova-plugin-contacts/www/ContactAddress.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+/**
+* Contact address.
+* @constructor
+* @param {DOMString} id unique identifier, should only be set by native code
+* @param formatted // NOTE: not a W3C standard
+* @param streetAddress
+* @param locality
+* @param region
+* @param postalCode
+* @param country
+*/
+
+var ContactAddress = function(pref, type, formatted, streetAddress, locality, region, postalCode, country) {
+    this.id = null;
+    this.pref = (typeof pref != 'undefined' ? pref : false);
+    this.type = type || null;
+    this.formatted = formatted || null;
+    this.streetAddress = streetAddress || null;
+    this.locality = locality || null;
+    this.region = region || null;
+    this.postalCode = postalCode || null;
+    this.country = country || null;
+};
+
+module.exports = ContactAddress;

km0App/node_modules/cordova-plugin-contacts/www/ContactError.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+/**
+ *  ContactError.
+ *  An error code assigned by an implementation when an error has occurred
+ * @constructor
+ */
+var ContactError = function(err) {
+    this.code = (typeof err != 'undefined' ? err : null);
+};
+
+/**
+ * Error codes
+ */
+ContactError.UNKNOWN_ERROR = 0;
+ContactError.INVALID_ARGUMENT_ERROR = 1;
+ContactError.TIMEOUT_ERROR = 2;
+ContactError.PENDING_OPERATION_ERROR = 3;
+ContactError.IO_ERROR = 4;
+ContactError.NOT_SUPPORTED_ERROR = 5;
+ContactError.OPERATION_CANCELLED_ERROR = 6;
+ContactError.PERMISSION_DENIED_ERROR = 20;
+
+module.exports = ContactError;

km0App/node_modules/cordova-plugin-contacts/www/ContactField.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+/**
+* Generic contact field.
+* @constructor
+* @param {DOMString} id unique identifier, should only be set by native code // NOTE: not a W3C standard
+* @param type
+* @param value
+* @param pref
+*/
+var ContactField = function(type, value, pref) {
+    this.id = null;
+    this.type = (type && type.toString()) || null;
+    this.value = (value && value.toString()) || null;
+    this.pref = (typeof pref != 'undefined' ? pref : false);
+};
+
+module.exports = ContactField;

km0App/node_modules/cordova-plugin-contacts/www/ContactFieldType.js

+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+*/
+
+    // Possible field names for various platforms.
+    // Some field names are platform specific
+
+    var fieldType = {
+        addresses:      "addresses",
+        birthday:       "birthday",
+        categories:     "categories",
+        country:        "country",
+        department:     "department",
+        displayName:    "displayName",
+        emails:         "emails",
+        familyName:     "familyName",
+        formatted:      "formatted",
+        givenName:      "givenName",
+        honorificPrefix: "honorificPrefix",
+        honorificSuffix: "honorificSuffix",
+        id:             "id",
+        ims:            "ims",
+        locality:       "locality",
+        middleName:     "middleName",
+        name:           "name",
+        nickname:       "nickname",
+        note:           "note",
+        organizations:  "organizations",
+        phoneNumbers:   "phoneNumbers",
+        photos:         "photos",
+        postalCode:     "postalCode",
+        region:         "region",
+        streetAddress:  "streetAddress",
+        title:          "title",
+        urls:           "urls"
+    };
+
+    module.exports = fieldType;