Several standalone unit tests.

Author: jeffposnick

package.json

@@ -25,7 +25,7 @@
   },
   "scripts": {
     "lint": "eslint --format=codeframe .",
-    "test": "jasmine test/webpack3/index.js test/webpack4/index.js",
+    "test": "jasmine test/unit/* test/webpack3/index.js test/webpack4/index.js",
     "coverage": "nyc npm run test",
     "clean": "rimraf build",
     "build": "npm run clean && babel --out-dir=build src"

test/unit/create-html-element-string.js

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2018 Google Inc.
+ *
+ * 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.
+ */
+
+const createHtmlElementString = require('../../src/lib/create-html-element-string');
+
+describe(`Error Conditions:`, function() {
+  it(`should throw when called without an elementName`, function(done) {
+    expect(
+      () => createHtmlElementString({})
+    ).toThrowError('Please provide an element name.');
+
+    done();
+  });
+
+  it(`should throw when called with an elementName matching \\W`, function(done) {
+    expect(
+      () => createHtmlElementString({elementName: 'Testing!'})
+    ).toThrowError('The element name contains invalid characters.');
+
+    done();
+  });
+});
+
+describe(`Defaults Tests:`, function() {
+  it(`should support usage with just an elementName, and defaults for everything else`, function(done) {
+    const elementString = createHtmlElementString({
+      elementName: 'test',
+    });
+
+    expect(elementString).toEqual('<test>');
+
+    done();
+  });
+});
+
+describe(`Attributes Tests:`, function() {
+  it(`should support attributes without values`, function(done) {
+    const elementString = createHtmlElementString({
+      elementName: 'test',
+      attributes: {
+        one: '',
+        two: '',
+      }
+    });
+
+    expect(elementString).toEqual('<test one two>');
+
+    done();
+  });
+
+  it(`should support a mix of attributes with and without values`, function(done) {
+    const elementString = createHtmlElementString({
+      elementName: 'test',
+      attributes: {
+        one: '',
+        two: '2'
+      }
+    });
+
+    expect(elementString).toEqual('<test one two="2">');
+
+    done();
+  });
+
+  it(`should add the attributes sorted in alphanumeric order`, function(done) {
+    const elementString = createHtmlElementString({
+      elementName: 'test',
+      attributes: {
+        xyz: '3',
+        abc: '1',
+        def: '2'
+      }
+    });
+
+    expect(elementString).toEqual('<test abc="1" def="2" xyz="3">');
+
+    done();
+  });
+
+  it(`should properly escape the attribute values as strings`, function(done) {
+    const elementString = createHtmlElementString({
+      elementName: 'test',
+      attributes: {
+        string: `Strings: '"\``
+      }
+    });
+
+    expect(elementString).toEqual('<test string="Strings: \'\\"`">');
+
+    done();
+  });
+});
+
+describe(`Closing Tag Tests:`, function() {
+  it(`should add a closing tag when specified`, function(done) {
+    const elementString = createHtmlElementString({
+      elementName: 'test',
+      closingTagRequired: true,
+    });
+
+    expect(elementString).toEqual('<test></test>');
+
+    done();
+  });
+});

test/unit/determine-as-value.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2018 Google Inc.
+ *
+ * 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.
+ */
+
+const determineAsValue = require('../../src/lib/determine-as-value');
+
+describe(`Error Conditions:`, function() {
+  it(`should throw when called without an href value`, function(done) {
+    expect(
+      () => determineAsValue({optionsAs: 'ignored'})
+    ).toThrowError(`The 'href' parameter was not provided.`);
+
+    done();
+  });
+
+  it(`should throw when called with an invalid optionsAs value`, function(done) {
+    expect(
+      () => determineAsValue({href: '/', optionsAs: {}})
+    ).toThrowError(`The 'as' option isn't set to a recognized value: [object Object]`);
+
+    done();
+  });
+});
+
+describe(`OptionsAs Tests:`, function() {
+  it(`should support passing in a string`, function(done) {
+    const asValue = determineAsValue({href: '/', optionsAs: 'test'});
+
+    expect(asValue).toEqual('test');
+
+    done();
+  });
+
+  it(`should support passing in a function`, function(done) {
+    const asValue = determineAsValue({href: '/', optionsAs: (href) => href + 'test'});
+
+    expect(asValue).toEqual('/test');
+
+    done();
+  });
+
+  it(`should support passing in undefined, when href ends with .css`, function(done) {
+    const asValue = determineAsValue({href: '/test.css'});
+
+    expect(asValue).toEqual('style');
+
+    done();
+  });
+
+  it(`should support passing in undefined, when href ends with .woff2`, function(done) {
+    const asValue = determineAsValue({href: '/test.woff2'});
+
+    expect(asValue).toEqual('font');
+
+    done();
+  });
+
+  it(`should support passing in undefined, when href ends with .js`, function(done) {
+    const asValue = determineAsValue({href: '/test.js'});
+
+    expect(asValue).toEqual('script');
+
+    done();
+  });
+
+  it(`should support passing in undefined, when href ends with anything else`, function(done) {
+    const asValue = determineAsValue({href: '/test.ignored'});
+
+    expect(asValue).toEqual('script');
+
+    done();
+  });
+});

test/unit/insert-links-into-head.js

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2018 Google Inc.
+ *
+ * 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.
+ */
+
+const insertLinksIntoHead = require('../../src/lib/insert-links-into-head');
+
+describe(`Edge Conditions:`, function() {
+  it(`should throw when called with HTML lacking a </head> or <body>`, function(done) {
+    const html = '<html></html>';
+    expect(
+      () => insertLinksIntoHead({html, links: ['<link>']})
+    ).toThrowError(`The HTML provided did not contain a </head> or a <body>:\n\n<html></html>`);
+
+    done();
+  });
+
+  it(`should return the HTML as-is when there are no links`, function(done) {
+    const html = '<html><body></body></html>';
+    const updatedHtml = insertLinksIntoHead({html});
+
+    expect(updatedHtml).toEqual(html);
+
+    done();
+  });
+});
+
+describe(`Normal Conditions:`, function() {
+  it(`should support inserting a single link prior to the </head>`, function(done) {
+    const html = '<html><head></head><body></body></html>';
+    const updatedHtml = insertLinksIntoHead({
+      html,
+      links: ['<link>'],
+    });
+
+    expect(updatedHtml).toEqual(`<html><head><link>\n</head><body></body></html>`);
+
+    done();
+  });
+
+  it(`should support inserting multiple links prior to the </head>`, function(done) {
+    const html = '<html><head></head><body></body></html>';
+    const updatedHtml = insertLinksIntoHead({
+      html,
+      links: ['<link1>', '<link2>'],
+    });
+
+    expect(updatedHtml).toEqual(`<html><head><link1>\n<link2>\n</head><body></body></html>`);
+
+    done();
+  });
+
+  it(`should support inserting a single link prior to the <body> when there is no </head>`, function(done) {
+    const html = '<html><body></body></html>';
+    const updatedHtml = insertLinksIntoHead({
+      html,
+      links: ['<link1>'],
+    });
+
+    expect(updatedHtml).toEqual(`<html><head>\n<link1>\n</head>\n<body></body></html>`);
+
+    done();
+  });
+
+  it(`should support inserting multiple links prior to the <body> when there is no </head>`, function(done) {
+    const html = '<html><body></body></html>';
+    const updatedHtml = insertLinksIntoHead({
+      html,
+      links: ['<link1>', '<link2>'],
+    });
+
+    expect(updatedHtml).toEqual(`<html><head>\n<link1>\n<link2>\n</head>\n<body></body></html>`);
+
+    done();
+  });
+});