blockHeadless variable

Author: xr0master

src/errors/headlessError/headlessError.spec.ts

@@ -0,0 +1,15 @@
+import { it, expect } from '@jest/globals';
+
+import { EmailJSResponseStatus } from '../../models/EmailJSResponseStatus';
+import { headlessError } from './headlessError';
+
+it('should return EmailJSResponseStatus', () => {
+  expect(headlessError()).toBeInstanceOf(EmailJSResponseStatus);
+});
+
+it('should return status 451', () => {
+  expect(headlessError()).toEqual({
+    status: 451,
+    text: 'Unavailable For Headless Browser',
+  });
+});

src/errors/headlessError/headlessError.ts

@@ -0,0 +1,5 @@
+import { EmailJSResponseStatus } from '../../models/EmailJSResponseStatus';
+
+export const headlessError = () => {
+  return new EmailJSResponseStatus(451, 'Unavailable For Headless Browser');
+};

src/methods/init/init.ts

@@ -17,6 +17,7 @@ export const init = (
   const opts = buildOptions(options);
 
   store.publicKey = opts.publicKey;
+  store.blockHeadless = opts.blockHeadless;
   store.limitRate = opts.limitRate || store.limitRate;
   store.blockList = opts.blockList || store.blockList;
   store.origin = opts.origin || origin;

src/methods/send/send.ts

@@ -1,11 +1,13 @@
+import type { EmailJSResponseStatus } from '../../models/EmailJSResponseStatus';
+import type { Options } from '../../types/Options';
+
 import { store } from '../../store/store';
 import { sendPost } from '../../api/sendPost';
 import { buildOptions } from '../../utils/buildOptions/buildOptions';
 import { validateParams } from '../../utils/validateParams/validateParams';
 import { validateTemplateParams } from '../../utils/validateTemplateParams/validateTemplateParams';
-
-import type { EmailJSResponseStatus } from '../../models/EmailJSResponseStatus';
-import type { Options } from '../../types/Options';
+import { isHeadless } from '../../utils/isHeadless/isHeadless';
+import { headlessError } from '../../errors/headlessError/headlessError';
 
 /**
  * Send a template to the specific EmailJS service
@@ -23,6 +25,11 @@ export const send = (
 ): Promise<EmailJSResponseStatus> => {
   const opts = buildOptions(options);
   const publicKey = opts.publicKey || store.publicKey;
+  const blockHeadless = opts.blockHeadless || store.blockHeadless;
+
+  if (blockHeadless && isHeadless(navigator)) {
+    return Promise.reject(headlessError());
+  }
 
   validateParams(publicKey, serviceID, templateID);
   validateTemplateParams(templateParams);

src/methods/sendForm/sendForm.ts

@@ -1,11 +1,13 @@
+import type { EmailJSResponseStatus } from '../../models/EmailJSResponseStatus';
+import type { Options } from '../../types/Options';
+
 import { store } from '../../store/store';
 import { sendPost } from '../../api/sendPost';
 import { buildOptions } from '../../utils/buildOptions/buildOptions';
 import { validateForm } from '../../utils/validateForm/validateForm';
 import { validateParams } from '../../utils/validateParams/validateParams';
-
-import type { EmailJSResponseStatus } from '../../models/EmailJSResponseStatus';
-import type { Options } from '../../types/Options';
+import { isHeadless } from '../../utils/isHeadless/isHeadless';
+import { headlessError } from '../../errors/headlessError/headlessError';
 
 const findHTMLForm = (form: string | HTMLFormElement): HTMLFormElement | null => {
   return typeof form === 'string' ? document.querySelector<HTMLFormElement>(form) : form;
@@ -27,6 +29,12 @@ export const sendForm = (
 ): Promise<EmailJSResponseStatus> => {
   const opts = buildOptions(options);
   const publicKey = opts.publicKey || store.publicKey;
+  const blockHeadless = opts.blockHeadless || store.blockHeadless;
+
+  if (blockHeadless && isHeadless(navigator)) {
+    return Promise.reject(headlessError());
+  }
+
   const currentForm = findHTMLForm(form);
 
   validateParams(publicKey, serviceID, templateID);

src/store/store.ts

@@ -2,6 +2,7 @@ import type { Options } from '../types/Options';
 
 export const store: Options = {
   origin: 'https://api.emailjs.com',
+  blockHeadless: false,
   limitRate: 0,
   blockList: [],
 };

src/types/Options.ts

@@ -1,6 +1,7 @@
 export interface Options {
   origin?: string;
   publicKey?: string;
+  blockHeadless?: boolean;
   limitRate?: number;
   blockList?: string[];
 }