Narcissistic Preening Monarch
    Wondering what’s next for npm?Check out our public roadmap! »

    @nativescript/email
    TypeScript icon, indicating that this package has built-in type declarations

    2.0.5 • Public • Published

    NativeScript Email

    NPM version Downloads Twitter Follow

    You can use this plugin to compose an e-mail, have the user edit the draft manually, and send it.

    Note that this plugin depends on the default mail app. If you want a fallback to a third party client app like Gmail or Outlook, then check for availability, and if not available use a solution like the Social Share plugin.

    ns plugin add @nativescript/email

    Usage

    API

    To use this plugin you must first require/import it:

    TypeScript

    import * as email from "@nativescript/email";
    // or
    import { compose } from "@nativescript/email";
    // or even
    import { compose as composeEmail } from "@nativescript/email";

    JavaScript

    var email = require("@nativescript/email");

    available

    TypeScript

      email.available().then((avail: boolean) => {
          console.log("Email available? " + avail);
      })

    JavaScript

      email.available().then(function(avail) {
          console.log("Email available? " + avail);
      })

    compose

    JavaScript

      // let's first create a File object
      import { knownFolders } from "@nativescript/core";
      var appPath = knownFolders.currentApp().path;
      var logoPath = appPath + "/res/telerik-logo.png";
    
      email.compose({
          subject: "Yo",
          body: "Hello <strong>dude</strong> :)",
          to: ['eddyverbruggen@gmail.com', 'to@person2.com'],
          cc: ['ccperson@somewhere.com'],
          bcc: ['eddy@combidesk.com', 'eddy@x-services.nl'],
          attachments: [
            {
                fileName: 'arrow1.png',
                path: 'base64://iVBORw0KGgoAAAANSUhEUgAAABYAAAAoCAYAAAD6xArmAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAHGlET1QAAAACAAAAAAAAABQAAAAoAAAAFAAAABQAAAB5EsHiAAAAAEVJREFUSA1iYKAimDhxYjwIU9FIBgaQgZMmTfoPwlOmTJGniuHIhlLNxaOGwiNqNEypkwlGk9RokoIUfaM5ijo5Clh9AAAAAP//ksWFvgAAAEFJREFUY5g4cWL8pEmT/oMwiM1ATTBqONbQHA2W0WDBGgJYBUdTy2iwYA0BrILDI7VMmTJFHqv3yBUEBQsIg/QDAJNpcv6v+k1ZAAAAAElFTkSuQmCC',
                mimeType: 'image/png'
            },
            {
                fileName: 'telerik-logo.png',
                path: logoPath,
                mimeType: 'image/png'
          }]
      }).then(
        function() {
          console.log("Email composer closed");
        }, function(err) {
          console.log("Error: " + err);
        });

    Full attachment support has been added to 1.3.0 per the example above.

    Since 1.4.0 the promise will be rejected in case a file can't be found.

    Usage with Angular

    Check out this tutorial (YouTube) to learn how to use this plugin in a NativeScript-Angular app.

    Known issues

    On iOS you can't use the simulator to test the plugin because of an iOS limitation. To prevent a crash this plugin returns false when available is invoked on the iOS sim.

    License

    Apache License Version 2.0

    Install

    npm i @nativescript/email

    DownloadsWeekly Downloads

    355

    Version

    2.0.5

    License

    Apache-2.0

    Unpacked Size

    57.6 kB

    Total Files

    13

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar