feat: add TO support for email sharer

Author: avdeev

README.md

@@ -230,6 +230,8 @@ email({
 })
 ```
 
+You can use `getEmailUrl(options)` for getting URL.
+
 ### `linkedin(options)`
 
 Share on LinkedIn

src/main.js

@@ -3,7 +3,7 @@ import { fbShare, getFbShareUrl } from './sharers/fbShare';
 import { fbButton, getFbButtonUrl } from './sharers/fbButton';
 import gp from './sharers/gp';
 import mail from './sharers/mail';
-import email from './sharers/email';
+import { email, getEmailUrl } from './sharers/email';
 import { ok, getOkUrl } from './sharers/ok';
 import { telegram, getTelegramUrl } from './sharers/telegram';
 import { tw, getTwUrl } from './sharers/tw';
@@ -31,7 +31,7 @@ export {
   vk, getVkUrl,
   ok, getOkUrl,
   mail,
-  email,
+  email, getEmailUrl,
   linkedin,
 
   whatsapp, getWhatsappUrl,

src/sharers/email.js

@@ -1,12 +1,18 @@
 import encodeParams from '../utils/encodeParams';
 
-export default function email(options = {}) {
+export function getEmailUrl(options = {}) {
   const {
-    url, title, description, subject,
+    to, url, title, description, subject,
   } = options;
+
   const params = encodeParams({
     subject,
     body: `${title || ''}\r\n${description || ''}\r\n${url || ''}`,
   });
-  return window.location.assign(`mailto:?${params}`);
+
+  return `mailto:${to || ''}?${params}`;
+}
+
+export function email(options = {}) {
+  return window.location.assign(getEmailUrl(options));
 }

src/sharers/tests/email.test.js

@@ -1,6 +1,6 @@
 import faker from 'faker';
 
-import email from '../email';
+import { email } from '../email';
 
 describe('email', () => {
   beforeEach(() => {
@@ -13,6 +13,12 @@ describe('email', () => {
     expect(window.location.assign).toBeCalledWith('mailto:?body=%0D%0A%0D%0A');
   });
 
+  it('should call with to', () => {
+    const fixture = faker.internet.email();
+    email({ to: fixture });
+    expect(window.location.assign).toBeCalledWith(`mailto:${fixture}?body=%0D%0A%0D%0A`);
+  });
+
   it('should call with url', () => {
     const fixture = faker.internet.url();
     email({ url: fixture });

vanilla-sharing.d.ts

@@ -30,7 +30,10 @@ export function ok(...args: any[]): any;
 export function getOkUrl(...args: any[]): string;
 
 export function mail(...args: any[]): any;
+
 export function email(...args: any[]): any;
+export function getEmailUrl(...args: any[]): any;
+
 export function linkedin(...args: any[]): any;
 
 export function whatsapp(...args: any[]): any;