From 889cc75ab44cfb14e0a65a0286eb0aa1c9a2d68e Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Fri, 6 Apr 2018 20:24:59 +0300 Subject: [PATCH 01/36] Added octicons as a devDependency Generated some SVG files to use on the new index page. --- docs/icons/chevron-left.svg | 1 + docs/icons/chevron-right.svg | 1 + docs/icons/code.svg | 1 + docs/icons/dashboard.svg | 1 + docs/icons/git-branch.svg | 1 + docs/icons/law.svg | 1 + docs/icons/organization.svg | 1 + docs/icons/star.svg | 1 + package-lock.json | 11 +++++++++-- package.json | 3 ++- 10 files changed, 19 insertions(+), 3 deletions(-) create mode 100644 docs/icons/chevron-left.svg create mode 100644 docs/icons/chevron-right.svg create mode 100644 docs/icons/code.svg create mode 100644 docs/icons/dashboard.svg create mode 100644 docs/icons/git-branch.svg create mode 100644 docs/icons/law.svg create mode 100644 docs/icons/organization.svg create mode 100644 docs/icons/star.svg diff --git a/docs/icons/chevron-left.svg b/docs/icons/chevron-left.svg new file mode 100644 index 000000000..5fa552a07 --- /dev/null +++ b/docs/icons/chevron-left.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/chevron-right.svg b/docs/icons/chevron-right.svg new file mode 100644 index 000000000..399d68762 --- /dev/null +++ b/docs/icons/chevron-right.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/code.svg b/docs/icons/code.svg new file mode 100644 index 000000000..d66aa59da --- /dev/null +++ b/docs/icons/code.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/dashboard.svg b/docs/icons/dashboard.svg new file mode 100644 index 000000000..8a27ad0ad --- /dev/null +++ b/docs/icons/dashboard.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/git-branch.svg b/docs/icons/git-branch.svg new file mode 100644 index 000000000..279e21c5c --- /dev/null +++ b/docs/icons/git-branch.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/law.svg b/docs/icons/law.svg new file mode 100644 index 000000000..61701b384 --- /dev/null +++ b/docs/icons/law.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/organization.svg b/docs/icons/organization.svg new file mode 100644 index 000000000..b968ecfcd --- /dev/null +++ b/docs/icons/organization.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/icons/star.svg b/docs/icons/star.svg new file mode 100644 index 000000000..4a584a3c9 --- /dev/null +++ b/docs/icons/star.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/package-lock.json b/package-lock.json index 5d7736c68..b264c644e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -3781,8 +3781,7 @@ "object-assign": { "version": "4.1.1", "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", - "integrity": "sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM=", - "dev": true + "integrity": "sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM=" }, "object-inspect": { "version": "1.3.0", @@ -3807,6 +3806,14 @@ "object-keys": "1.0.11" } }, + "octicons": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/octicons/-/octicons-7.2.0.tgz", + "integrity": "sha512-d7JFtVoeK07Anp0wRvZ7GJ+eCW5hGRvrGJn7wt64NnpaZdxlvDBFwnafLbljZoNnXCdlpgFoZz9yD+NLw1gXLA==", + "requires": { + "object-assign": "4.1.1" + } + }, "once": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", diff --git a/package.json b/package.json index 4dd3113d2..ea08a1e74 100644 --- a/package.json +++ b/package.json @@ -15,7 +15,8 @@ "rollup-plugin-babel-minify": "^3.1.2", "semistandard": "^11.0.0", "tap-spec": "^4.1.1", - "tape": "^4.8.0" + "tape": "^4.8.0", + "octicons": "^7.2.0" }, "name": "30-seconds-of-code", "description": "A collection of useful JavaScript snippets.", From dd57e0e9c188dd5824a45e943e31f202b07c0f86 Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Fri, 6 Apr 2018 20:55:59 +0300 Subject: [PATCH 02/36] Added new landing page as static file --- docs/mini/flavor.scss | 176 ++++++++++++++++++++++++++++++++++++++++ static-parts/index.html | 156 +++++++++++++++++++++++++++++++++++ 2 files changed, 332 insertions(+) create mode 100644 static-parts/index.html diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss index 6d3641d60..9a74715c7 100644 --- a/docs/mini/flavor.scss +++ b/docs/mini/flavor.scss @@ -464,3 +464,179 @@ button#disclaimer-close{ font-size: 0.85rem; background: 0; } + +// New styles for landing page + +#splash { + height: auto; + padding-bottom: 1.5rem; + background: linear-gradient(135deg, rgba(255,174,39,1) 0%,rgba(222,73,109,1) 100%); + #logo { + margin-top: 0; + margin-left: -0.5rem; + padding-top: 2rem; + text-align: center; + font-size: 2.25rem; + line-height: 2; + img { + vertical-align: top; + height: 4.5rem; + } + } + #tagline { + text-align: center; + padding: 0.5rem 25%; + } + #doc-link { + text-align: center; + margin-left: -0.5rem; + > a { + background: transparent; + border: 0.0625rem solid rgba(17,17,17,0.95); + transition: all 0.3s; + &:hover, &:focus { + background: rgba(17,17,17,0.95); + color: #e86957; + } + } + } + @media screen and (max-width:767px){ + #logo { + font-size: 1.75rem; + img { + height: 3.5rem; + } + } + #tagline { + padding: 0.25rem 17.5%; + font-size: 0.875rem; + } + #doc-link { + font-size: 0.875rem; + } + } + @media screen and (max-width: 383px){ + #logo { + font-size: 1.5rem; + img { + height: 3rem; + } + } + #tagline { + padding: 0.125rem 5%; + } + } + @media screen and (max-width: 479px){ + #tagline #tagline-lg { + display: none; + } + } +} + +@media screen and (min-width: 768px) { + .col-md-offset-1 { + margin-left: 8.33333%; + } +} + +@media screen and (min-width: 1280px) { + .col-lg-offset-2 { + margin-left: 16.66667%; + } +} + +h2.index-section { + border-left: 0.3125rem solid #de4a6d; + padding-left: 0.625rem; + margin-top: 2rem; +} + +#license-icon { + text-align: center; + @media screen and (min-width: 768px){ + position: relative; + top: calc(50% - 40px); + } + > svg { + border: 0.03125rem solid #444; + border-radius: 100%; + padding: 0.5rem; + fill: #444; + } +} + +#license { + vertical-align: middle; +} + +.no-padding { + padding: 0; +} + +#in-numbers { + background: #111; //#3f88c5; //#e15554; + padding-top: 1.25rem; + @media screen and (max-width: 767px){ + padding-bottom: 1rem; + } + color: #fff; + svg { + fill: #fff; + } +} + +#snippet-count, #contrib-count, #commit-count, #test-count { + font-size: 1.5rem; +} + +ul#links { + list-style: none; + padding-left: 0; + li + li { + padding-top: 0.625rem; + } +} + +.pick:not(.selected) { + display: none; +} + +.pick.selected { + overflow: visible; + button.next { + position: absolute; + top: 50%; + right: -1rem; + > svg { + margin-right: -0.0625rem; + } + } + button.previous { + position: absolute; + top: 50%; + left: -1rem; + > svg { + margin-left: -0.0625rem; + } + } + button.previous, button.next { + border-radius: 100%; + background: #f8f8f8; + border: 0.03125rem solid #ddd; + width: 1.5rem; + height: 1.5rem; + padding: 0; + margin: 0; + transition: all 0.3s; + > svg { + fill: #888; + transition: all 0.3s; + } + &:hover, &:focus { + border-color: #aaa; + > svg { + fill: #444; + } + } + } +} diff --git a/static-parts/index.html b/static-parts/index.html new file mode 100644 index 000000000..6f2010aa6 --- /dev/null +++ b/static-parts/index.html @@ -0,0 +1,156 @@ + + + + + 30 seconds of code + + + + + + + + + + + +
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+ +
+
+
+
+

Our philosophy

+

The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


+
+
+
+
+
+
+
+
+

In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

+
+

+
+
+
+
+

Today's picks

+
+ +

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
+  document.documentElement.clientHeight + window.scrollY >=
+  (document.documentElement.scrollHeight || document.documentElement.clientHeight);
+
bottomVisible(); // true
+
+

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
+
const firstTwoMax = ary(Math.max, 2);
+[[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
+
+
+
+
+
+
+
+
+
+ +

295
snippets


+
+
+ +

114
contributors


+
+
+ +

3028
commits

+
+
+ +

999
tests

+
+
+
+
+
+
+
+

Getting started

+
+
+
+
+
+

Related projects

+

The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

+
+
+
+
+
+

Top contributors

+

TODO using Github API


+
+
+
+
+

How to contribute

+

TODO


+
+
+
+ + + + From 51daeafc54c7608a0e3bf331a452d1c379dace8a Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Fri, 6 Apr 2018 22:24:39 +0300 Subject: [PATCH 03/36] Updated logo with gradient --- logo.png | Bin 11077 -> 60432 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/logo.png b/logo.png index 654505a7a6dd75482cf6cc44a72c1dbe0c2bf8c8..eea13eb6ce06669f3f5e115e0c321130dead697f 100644 GIT binary patch literal 60432 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 literal 11077 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 MqUPJG*Oo#52ie$alK=n! From f2993323d1eb99170e279beacf72265564199c6b Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Fri, 6 Apr 2018 22:24:39 +0300 Subject: [PATCH 04/36] Revert "Updated logo with gradient" This reverts commit 764754a03e5f00663d1bf7767d13e36ad1cd4f75. --- logo.png | Bin 60432 -> 11077 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/logo.png b/logo.png index eea13eb6ce06669f3f5e115e0c321130dead697f..654505a7a6dd75482cf6cc44a72c1dbe0c2bf8c8 100644 GIT binary patch literal 11077 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 MqUPJG*Oo#52ie$alK=n! literal 60432 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 From 2c0403596113a29d7133725c75449633e2fecb22 Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 10:43:42 +0300 Subject: [PATCH 05/36] Individual pages for snippet tags Mostyl complete --- docs/adapter.html | 155 ++++++ docs/array.html | 524 ++++++++++++++++++ docs/browser.html | 337 +++++++++++ docs/date.html | 121 ++++ docs/function.html | 275 +++++++++ docs/math.html | 278 ++++++++++ docs/mini.css | 2 +- docs/node.html | 157 ++++++ docs/object.html | 335 +++++++++++ docs/string.html | 264 +++++++++ docs/type.html | 184 ++++++ docs/utility.html | 275 +++++++++ scripts/web.js | 102 ++-- .../{index-end.html => page-end.html} | 0 .../{index-start.html => page-start.html} | 10 +- 15 files changed, 2949 insertions(+), 70 deletions(-) create mode 100644 docs/adapter.html create mode 100644 docs/array.html create mode 100644 docs/browser.html create mode 100644 docs/date.html create mode 100644 docs/function.html create mode 100644 docs/math.html create mode 100644 docs/node.html create mode 100644 docs/object.html create mode 100644 docs/string.html create mode 100644 docs/type.html create mode 100644 docs/utility.html rename static-parts/{index-end.html => page-end.html} (100%) rename static-parts/{index-start.html => page-start.html} (95%) diff --git a/docs/adapter.html b/docs/adapter.html new file mode 100644 index 000000000..37eac4e45 --- /dev/null +++ b/docs/adapter.html @@ -0,0 +1,155 @@ +Adapter - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Adapter

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
+
const firstTwoMax = ary(Math.max, 2);
+[[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
+

call

Given a key and a set of arguments, call them when given a context. Primarily useful in composition.

Use a closure to call a stored key with stored arguments.

const call = (key, ...args) => context => context[key](...args);
+
Promise.resolve([1, 2, 3])
+  .then(call('map', x => 2 * x))
+  .then(console.log); //[ 2, 4, 6 ]
+const map = call.bind(null, 'map');
+Promise.resolve([1, 2, 3])
+  .then(map(x => 2 * x))
+  .then(console.log); //[ 2, 4, 6 ]
+

collectInto

Changes a function that accepts an array into a variadic function.

Given a function, return a closure that collects all inputs into an array-accepting function.

const collectInto = fn => (...args) => fn(args);
+
const Pall = collectInto(Promise.all.bind(Promise));
+let p1 = Promise.resolve(1);
+let p2 = Promise.resolve(2);
+let p3 = new Promise(resolve => setTimeout(resolve, 2000, 3));
+Pall(p1, p2, p3).then(console.log); // [1, 2, 3] (after about 2 seconds)
+

flip

Flip takes a function as an argument, then makes the first argument the last.

Return a closure that takes variadic inputs, and splices the last argument to make it the first argument before applying the rest.

const flip = fn => (first, ...rest) => fn(...rest, first);
+
let a = { name: 'John Smith' };
+let b = {};
+const mergeFrom = flip(Object.assign);
+let mergePerson = mergeFrom.bind(null, a);
+mergePerson(b); // == b
+b = {};
+Object.assign(b, a); // == b
+

over

Creates a function that invokes each provided function with the arguments it receives and returns the results.

Use Array.map() and Function.apply() to apply each function to the given arguments.

const over = (...fns) => (...args) => fns.map(fn => fn.apply(null, args));
+
const minMax = over(Math.min, Math.max);
+minMax(1, 2, 3, 4, 5); // [1,5]
+

overArgs

Creates a function that invokes the provided function with its arguments transformed.

Use Array.map() to apply transforms to args in combination with the spread operator (...) to pass the transformed arguments to fn.

const overArgs = (fn, transforms) => (...args) => fn(...args.map((val, i) => transforms[i](val)));
+
const square = n => n * n;
+const double = n => n * 2;
+const fn = overArgs((x, y) => [x, y], [square, double]);
+fn(9, 3); // [81, 6]
+

pipeAsyncFunctions

Performs left-to-right function composition for asynchronous functions.

Use Array.reduce() with the spread operator (...) to perform left-to-right function composition using Promise.then(). The functions can return a combination of: simple values, Promise's, or they can be defined as async ones returning through await. All functions must be unary.

const pipeAsyncFunctions = (...fns) => arg => fns.reduce((p, f) => p.then(f), Promise.resolve(arg));
+
const sum = pipeAsyncFunctions(
+  x => x + 1,
+  x => new Promise(resolve => setTimeout(() => resolve(x + 2), 1000)),
+  x => x + 3,
+  async x => (await x) + 4
+);
+(async () => {
+  console.log(await sum(5)); // 15 (after one second)
+})();
+

pipeFunctions

Performs left-to-right function composition.

Use Array.reduce() with the spread operator (...) to perform left-to-right function composition. The first (leftmost) function can accept one or more arguments; the remaining functions must be unary.

const pipeFunctions = (...fns) => fns.reduce((f, g) => (...args) => g(f(...args)));
+
const add5 = x => x + 5;
+const multiply = (x, y) => x * y;
+const multiplyAndAdd5 = pipeFunctions(multiply, add5);
+multiplyAndAdd5(5, 2); // 15
+

promisify

Converts an asynchronous function to return a promise.

Use currying to return a function returning a Promise that calls the original function. Use the ...rest operator to pass in all the parameters.

In Node 8+, you can use util.promisify

const promisify = func => (...args) =>
+  new Promise((resolve, reject) =>
+    func(...args, (err, result) => (err ? reject(err) : resolve(result)))
+  );
+
const delay = promisify((d, cb) => setTimeout(cb, d));
+delay(2000).then(() => console.log('Hi!')); // // Promise resolves after 2s
+

rearg

Creates a function that invokes the provided function with its arguments arranged according to the specified indexes.

Use Array.reduce() and Array.indexOf() to reorder arguments based on indexes in combination with the spread operator (...) to pass the transformed arguments to fn.

const rearg = (fn, indexes) => (...args) =>
+  fn(
+    ...args.reduce(
+      (acc, val, i) => ((acc[indexes.indexOf(i)] = val), acc),
+      Array.from({ length: indexes.length })
+    )
+  );
+
var rearged = rearg(
+  function(a, b, c) {
+    return [a, b, c];
+  },
+  [2, 0, 1]
+);
+rearged('b', 'c', 'a'); // ['a', 'b', 'c']
+

spreadOver

Takes a variadic function and returns a closure that accepts an array of arguments to map to the inputs of the function.

Use closures and the spread operator (...) to map the array of arguments to the inputs of the function.

const spreadOver = fn => argsArr => fn(...argsArr);
+
const arrayMax = spreadOver(Math.max);
+arrayMax([1, 2, 3]); // 3
+

unary

Creates a function that accepts up to one argument, ignoring any additional arguments.

Call the provided function, fn, with just the first argument given.

const unary = fn => val => fn(val);
+
['6', '8', '10'].map(unary(parseInt)); // [6, 8, 10]
+
\ No newline at end of file diff --git a/docs/array.html b/docs/array.html new file mode 100644 index 000000000..2188e68ea --- /dev/null +++ b/docs/array.html @@ -0,0 +1,524 @@ +Array - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Array

all

Returns true if the provided predicate function returns true for all elements in a collection, false otherwise.

Use Array.every() to test if all elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.

const all = (arr, fn = Boolean) => arr.every(fn);
+
all([4, 2, 3], x => x > 1); // true
+all([1, 2, 3]); // true
+

any

Returns true if the provided predicate function returns true for at least one element in a collection, false otherwise.

Use Array.some() to test if any elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.

const any = (arr, fn = Boolean) => arr.some(fn);
+
any([0, 1, 2, 0], x => x >= 2); // true
+any([0, 0, 1, 0]); // true
+

bifurcate

Splits values into two groups. If an element in filter is truthy, the corresponding element in the collection belongs to the first group; otherwise, it belongs to the second group.

Use Array.reduce() and Array.push() to add elements to groups, based on filter.

const bifurcate = (arr, filter) =>
+  arr.reduce((acc, val, i) => (acc[filter[i] ? 0 : 1].push(val), acc), [[], []]);
+
bifurcate(['beep', 'boop', 'foo', 'bar'], [true, true, false, true]); // [ ['beep', 'boop', 'bar'], ['foo'] ]
+

bifurcateBy

Splits values into two groups according to a predicate function, which specifies which group an element in the input collection belongs to. If the predicate function returns a truthy value, the collection element belongs to the first group; otherwise, it belongs to the second group.

Use Array.reduce() and Array.push() to add elements to groups, based on the value returned by fn for each element.

const bifurcateBy = (arr, fn) =>
+  arr.reduce((acc, val, i) => (acc[fn(val, i) ? 0 : 1].push(val), acc), [[], []]);
+
bifurcateBy(['beep', 'boop', 'foo', 'bar'], x => x[0] === 'b'); // [ ['beep', 'boop', 'bar'], ['foo'] ]
+

chunk

Chunks an array into smaller arrays of a specified size.

Use Array.from() to create a new array, that fits the number of chunks that will be produced. Use Array.slice() to map each element of the new array to a chunk the length of size. If the original array can't be split evenly, the final chunk will contain the remaining elements.

const chunk = (arr, size) =>
+  Array.from({ length: Math.ceil(arr.length / size) }, (v, i) =>
+    arr.slice(i * size, i * size + size)
+  );
+
chunk([1, 2, 3, 4, 5], 2); // [[1,2],[3,4],[5]]
+

compact

Removes falsey values from an array.

Use Array.filter() to filter out falsey values (false, null, 0, "", undefined, and NaN).

const compact = arr => arr.filter(Boolean);
+
compact([0, 1, false, 2, '', 3, 'a', 'e' * 23, NaN, 's', 34]); // [ 1, 2, 3, 'a', 's', 34 ]
+

countBy

Groups the elements of an array based on the given function and returns the count of elements in each group.

Use Array.map() to map the values of an array to a function or property name. Use Array.reduce() to create an object, where the keys are produced from the mapped results.

const countBy = (arr, fn) =>
+  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val, i) => {
+    acc[val] = (acc[val] || 0) + 1;
+    return acc;
+  }, {});
+
countBy([6.1, 4.2, 6.3], Math.floor); // {4: 1, 6: 2}
+countBy(['one', 'two', 'three'], 'length'); // {3: 2, 5: 1}
+

countOccurrences

Counts the occurrences of a value in an array.

Use Array.reduce() to increment a counter each time you encounter the specific value inside the array.

const countOccurrences = (arr, val) => arr.reduce((a, v) => (v === val ? a + 1 : a + 0), 0);
+
countOccurrences([1, 1, 2, 1, 2, 3], 1); // 3
+

deepFlatten

Deep flattens an array.

Use recursion. Use Array.concat() with an empty array ([]) and the spread operator (...) to flatten an array. Recursively flatten each element that is an array.

const deepFlatten = arr => [].concat(...arr.map(v => (Array.isArray(v) ? deepFlatten(v) : v)));
+
deepFlatten([1, [2], [[3], 4], 5]); // [1,2,3,4,5]
+

difference

Returns the difference between two arrays.

Create a Set from b, then use Array.filter() on a to only keep values not contained in b.

const difference = (a, b) => {
+  const s = new Set(b);
+  return a.filter(x => !s.has(x));
+};
+
difference([1, 2, 3], [1, 2, 4]); // [3]
+

differenceBy

Returns the difference between two arrays, after applying the provided function to each array element of both.

Create a Set by applying fn to each element in b, then use Array.filter() in combination with fn on a to only keep values not contained in the previously created set.

const differenceBy = (a, b, fn) => {
+  const s = new Set(b.map(v => fn(v)));
+  return a.filter(x => !s.has(fn(x)));
+};
+
differenceBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [1.2]
+differenceBy([{ x: 2 }, { x: 1 }], [{ x: 1 }], v => v.x); // [ { x: 2 } ]
+

differenceWith

Filters out all values from an array for which the comparator function does not return true.

Use Array.filter() and Array.findIndex() to find the appropriate values.

const differenceWith = (arr, val, comp) => arr.filter(a => val.findIndex(b => comp(a, b)) === -1);
+
differenceWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0], (a, b) => Math.round(a) === Math.round(b)); // [1, 1.2]
+

drop

Returns a new array with n elements removed from the left.

Use Array.slice() to slice the remove the specified number of elements from the left.

const drop = (arr, n = 1) => arr.slice(n);
+
drop([1, 2, 3]); // [2,3]
+drop([1, 2, 3], 2); // [3]
+drop([1, 2, 3], 42); // []
+

dropRight

Returns a new array with n elements removed from the right.

Use Array.slice() to slice the remove the specified number of elements from the right.

const dropRight = (arr, n = 1) => arr.slice(0, -n);
+
dropRight([1, 2, 3]); // [1,2]
+dropRight([1, 2, 3], 2); // [1]
+dropRight([1, 2, 3], 42); // []
+

dropRightWhile

Removes elements from the end of an array until the passed function returns true. Returns the remaining elements in the array.

Loop through the array, using Array.slice() to drop the last element of the array until the returned value from the function is true. Returns the remaining elements.

const dropRightWhile = (arr, func) => {
+  while (arr.length > 0 && !func(arr[arr.length - 1])) arr = arr.slice(0, -1);
+  return arr;
+};
+
dropRightWhile([1, 2, 3, 4], n => n < 3); // [1, 2]
+

dropWhile

Removes elements in an array until the passed function returns true. Returns the remaining elements in the array.

Loop through the array, using Array.slice() to drop the first element of the array until the returned value from the function is true. Returns the remaining elements.

const dropWhile = (arr, func) => {
+  while (arr.length > 0 && !func(arr[0])) arr = arr.slice(1);
+  return arr;
+};
+
dropWhile([1, 2, 3, 4], n => n >= 3); // [3,4]
+

everyNth

Returns every nth element in an array.

Use Array.filter() to create a new array that contains every nth element of a given array.

const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
+
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
+

filterNonUnique

Filters out the non-unique values in an array.

Use Array.filter() for an array containing only the unique values.

const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
+
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]
+

findLast

Returns the last element for which the provided function returns a truthy value.

Use Array.filter() to remove elements for which fn returns falsey values, Array.slice(-1) to get the last one.

const findLast = (arr, fn) => arr.filter(fn).slice(-1)[0];
+
findLast([1, 2, 3, 4], n => n % 2 === 1); // 3
+

findLastIndex

Returns the index of the last element for which the provided function returns a truthy value.

Use Array.map() to map each element to an array with its index and value. Use Array.filter() to remove elements for which fn returns falsey values, Array.slice(-1) to get the last one.

const findLastIndex = (arr, fn) =>
+  arr
+    .map((val, i) => [i, val])
+    .filter(val => fn(val[1], val[0], arr))
+    .slice(-1)[0][0];
+
findLastIndex([1, 2, 3, 4], n => n % 2 === 1); // 2 (index of the value 3)
+

flatten

Flattens an array up to the specified depth.

Use recursion, decrementing depth by 1 for each level of depth. Use Array.reduce() and Array.concat() to merge elements or arrays. Base case, for depth equal to 1 stops recursion. Omit the second argument, depth to flatten only to a depth of 1 (single flatten).

const flatten = (arr, depth = 1) =>
+  arr.reduce((a, v) => a.concat(depth > 1 && Array.isArray(v) ? flatten(v, depth - 1) : v), []);
+
flatten([1, [2], 3, 4]); // [1, 2, 3, 4]
+flatten([1, [2, [3, [4, 5], 6], 7], 8], 2); // [1, 2, 3, [4, 5], 6, 7, 8]
+

forEachRight

Executes a provided function once for each array element, starting from the array's last element.

Use Array.slice(0) to clone the given array, Array.reverse() to reverse it and Array.forEach() to iterate over the reversed array.

const forEachRight = (arr, callback) =>
+  arr
+    .slice(0)
+    .reverse()
+    .forEach(callback);
+
forEachRight([1, 2, 3, 4], val => console.log(val)); // '4', '3', '2', '1'
+

groupBy

Groups the elements of an array based on the given function.

Use Array.map() to map the values of an array to a function or property name. Use Array.reduce() to create an object, where the keys are produced from the mapped results.

const groupBy = (arr, fn) =>
+  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val, i) => {
+    acc[val] = (acc[val] || []).concat(arr[i]);
+    return acc;
+  }, {});
+
groupBy([6.1, 4.2, 6.3], Math.floor); // {4: [4.2], 6: [6.1, 6.3]}
+groupBy(['one', 'two', 'three'], 'length'); // {3: ['one', 'two'], 5: ['three']}
+

Returns the head of a list.

Use arr[0] to return the first element of the passed array.

const head = arr => arr[0];
+
head([1, 2, 3]); // 1
+

indexOfAll

Returns all indices of val in an array. If val never occurs, returns [].

Use Array.forEach() to loop over elements and Array.push() to store indices for matching elements. Return the array of indices.

const indexOfAll = (arr, val) => {
+  const indices = [];
+  arr.forEach((el, i) => el === val && indices.push(i));
+  return indices;
+};
+
indexOfAll([1, 2, 3, 1, 2, 3], 1); // [0,3]
+indexOfAll([1, 2, 3], 4); // []
+

initial

Returns all the elements of an array except the last one.

Use arr.slice(0,-1) to return all but the last element of the array.

const initial = arr => arr.slice(0, -1);
+
initial([1, 2, 3]); // [1,2]
+

initialize2DArray

Initializes a 2D array of given width and height and value.

Use Array.map() to generate h rows where each is a new array of size w initialize with value. If the value is not provided, default to null.

const initialize2DArray = (w, h, val = null) =>
+  Array.from({ length: h }).map(() => Array.from({ length: w }).fill(val));
+
initialize2DArray(2, 2, 0); // [[0,0], [0,0]]
+

initializeArrayWithRange

Initializes an array containing the numbers in the specified range where start and end are inclusive with their common difference step.

Use Array.from(Math.ceil((end+1-start)/step)) to create an array of the desired length(the amounts of elements is equal to (end-start)/step or (end+1-start)/step for inclusive end), Array.map() to fill with the desired values in a range. You can omit start to use a default value of 0. You can omit step to use a default value of 1.

const initializeArrayWithRange = (end, start = 0, step = 1) =>
+  Array.from({ length: Math.ceil((end + 1 - start) / step) }).map((v, i) => i * step + start);
+
initializeArrayWithRange(5); // [0,1,2,3,4,5]
+initializeArrayWithRange(7, 3); // [3,4,5,6,7]
+initializeArrayWithRange(9, 0, 2); // [0,2,4,6,8]
+

initializeArrayWithRangeRight

Initializes an array containing the numbers in the specified range (in reverse) where start and end are inclusive with their common difference step.

Use Array.from(Math.ceil((end+1-start)/step)) to create an array of the desired length(the amounts of elements is equal to (end-start)/step or (end+1-start)/step for inclusive end), Array.map() to fill with the desired values in a range. You can omit start to use a default value of 0. You can omit step to use a default value of 1.

const initializeArrayWithRangeRight = (end, start = 0, step = 1) =>
+  Array.from({ length: Math.ceil((end + 1 - start) / step) }).map(
+    (v, i, arr) => (arr.length - i - 1) * step + start
+  );
+
initializeArrayWithRangeRight(5); // [5,4,3,2,1,0]
+initializeArrayWithRangeRight(7, 3); // [7,6,5,4,3]
+initializeArrayWithRangeRight(9, 0, 2); // [8,6,4,2,0]
+

initializeArrayWithValues

Initializes and fills an array with the specified values.

Use Array(n) to create an array of the desired length, fill(v) to fill it with the desired values. You can omit val to use a default value of 0.

const initializeArrayWithValues = (n, val = 0) => Array(n).fill(val);
+
initializeArrayWithValues(5, 2); // [2,2,2,2,2]
+

intersection

Returns a list of elements that exist in both arrays.

Create a Set from b, then use Array.filter() on a to only keep values contained in b.

const intersection = (a, b) => {
+  const s = new Set(b);
+  return a.filter(x => s.has(x));
+};
+
intersection([1, 2, 3], [4, 3, 2]); // [2,3]
+

intersectionBy

Returns a list of elements that exist in both arrays, after applying the provided function to each array element of both.

Create a Set by applying fn to all elements in b, then use Array.filter() on a to only keep elements, which produce values contained in b when fn is applied to them.

const intersectionBy = (a, b, fn) => {
+  const s = new Set(b.map(x => fn(x)));
+  return a.filter(x => s.has(fn(x)));
+};
+
intersectionBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [2.1]
+

intersectionWith

Returns a list of elements that exist in both arrays, using a provided comparator function.

Use Array.filter() and Array.findIndex() in combination with the provided comparator to determine intersecting values.

const intersectionWith = (a, b, comp) => a.filter(x => b.findIndex(y => comp(x, y)) !== -1);
+
intersectionWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0, 3.9], (a, b) => Math.round(a) === Math.round(b)); // [1.5, 3, 0]
+

isSorted

Returns 1 if the array is sorted in ascending order, -1 if it is sorted in descending order or 0 if it is not sorted.

Calculate the ordering direction for the first two elements. Use Object.entries() to loop over array objects and compare them in pairs. Return 0 if the direction changes or the direction if the last element is reached.

const isSorted = arr => {
+  let direction = -(arr[0] - arr[1]);
+  for (let [i, val] of arr.entries()) {
+    direction = !direction ? -(arr[i - 1] - arr[i]) : direction;
+    if (i === arr.length - 1) return !direction ? 0 : direction;
+    else if ((val - arr[i + 1]) * direction > 0) return 0;
+  }
+};
+
isSorted([0, 1, 2, 2]); // 1
+isSorted([4, 3, 2]); // -1
+isSorted([4, 3, 5]); // 0
+

join

Joins all elements of an array into a string and returns this string. Uses a separator and an end separator.

Use Array.reduce() to combine elements into a string. Omit the second argument, separator, to use a default separator of ','. Omit the third argument, end, to use the same value as separator by default.

const join = (arr, separator = ',', end = separator) =>
+  arr.reduce(
+    (acc, val, i) =>
+      i === arr.length - 2
+        ? acc + val + end
+        : i === arr.length - 1 ? acc + val : acc + val + separator,
+    ''
+  );
+
join(['pen', 'pineapple', 'apple', 'pen'], ',', '&'); // "pen,pineapple,apple&pen"
+join(['pen', 'pineapple', 'apple', 'pen'], ','); // "pen,pineapple,apple,pen"
+join(['pen', 'pineapple', 'apple', 'pen']); // "pen,pineapple,apple,pen"
+

last

Returns the last element in an array.

Use arr.length - 1 to compute the index of the last element of the given array and returning it.

const last = arr => arr[arr.length - 1];
+
last([1, 2, 3]); // 3
+

longestItem

Takes any number of iterable objects or objects with a length property and returns the longest one.

Use Array.sort() to sort all arguments by length, return the first (longest) one.

const longestItem = (...vals) => [...vals].sort((a, b) => b.length - a.length)[0];
+
longestItem('this', 'is', 'a', 'testcase'); // 'testcase'
+longestItem(...['a', 'ab', 'abc']); // 'abc'
+longestItem(...['a', 'ab', 'abc'], 'abcd'); // 'abcd'
+longestItem([1, 2, 3], [1, 2], [1, 2, 3, 4, 5]); // [1, 2, 3, 4, 5]
+longestItem([1, 2, 3], 'foobar'); // 'foobar'
+

mapObjectadvanced

Maps the values of an array to an object using a function, where the key-value pairs consist of the original value as the key and the mapped value.

Use an anonymous inner function scope to declare an undefined memory space, using closures to store a return value. Use a new Array to store the array with a map of the function over its data set and a comma operator to return a second step, without needing to move from one context to another (due to closures and order of operations).

const mapObject = (arr, fn) =>
+  (a => (
+    (a = [arr, arr.map(fn)]), a[0].reduce((acc, val, ind) => ((acc[val] = a[1][ind]), acc), {})
+  ))();
+
const squareIt = arr => mapObject(arr, a => a * a);
+squareIt([1, 2, 3]); // { 1: 1, 2: 4, 3: 9 }
+

maxN

Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.

const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
+
maxN([1, 2, 3]); // [3]
+maxN([1, 2, 3], 2); // [3,2]
+

minN

Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.

const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
+
minN([1, 2, 3]); // [1]
+minN([1, 2, 3], 2); // [1,2]
+

none

Returns true if the provided predicate function returns false for all elements in a collection, false otherwise.

Use Array.some() to test if any elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.

const none = (arr, fn = Boolean) => !arr.some(fn);
+
none([0, 1, 3, 0], x => x == 2); // true
+none([0, 0, 0]); // true
+

nthElement

Returns the nth element of an array.

Use Array.slice() to get an array containing the nth element at the first place. If the index is out of bounds, return []. Omit the second argument, n, to get the first element of the array.

const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
+
nthElement(['a', 'b', 'c'], 1); // 'b'
+nthElement(['a', 'b', 'b'], -3); // 'a'
+

partition

Groups the elements into two arrays, depending on the provided function's truthiness for each element.

Use Array.reduce() to create an array of two arrays. Use Array.push() to add elements for which fn returns true to the first array and elements for which fn returns false to the second one.

const partition = (arr, fn) =>
+  arr.reduce(
+    (acc, val, i, arr) => {
+      acc[fn(val, i, arr) ? 0 : 1].push(val);
+      return acc;
+    },
+    [[], []]
+  );
+
const users = [{ user: 'barney', age: 36, active: false }, { user: 'fred', age: 40, active: true }];
+partition(users, o => o.active); // [[{ 'user': 'fred',    'age': 40, 'active': true }],[{ 'user': 'barney',  'age': 36, 'active': false }]]
+

permutations

⚠️ WARNING: This function's execution time increases exponentially with each array element. Anything more than 8 to 10 entries will cause your browser to hang as it tries to solve all the different combinations.

Generates all permutations of an array's elements (contains duplicates).

Use recursion. For each element in the given array, create all the partial permutations for the rest of its elements. Use Array.map() to combine the element with each partial permutation, then Array.reduce() to combine all permutations in one array. Base cases are for array length equal to 2 or 1.

const permutations = arr => {
+  if (arr.length <= 2) return arr.length === 2 ? [arr, [arr[1], arr[0]]] : arr;
+  return arr.reduce(
+    (acc, item, i) =>
+      acc.concat(
+        permutations([...arr.slice(0, i), ...arr.slice(i + 1)]).map(val => [item, ...val])
+      ),
+    []
+  );
+};
+
permutations([1, 33, 5]); // [ [ 1, 33, 5 ], [ 1, 5, 33 ], [ 33, 1, 5 ], [ 33, 5, 1 ], [ 5, 1, 33 ], [ 5, 33, 1 ] ]
+

pull

Mutates the original array to filter out the values specified.

Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values.

(For a snippet that does not mutate the original array see without)

const pull = (arr, ...args) => {
+  let argState = Array.isArray(args[0]) ? args[0] : args;
+  let pulled = arr.filter((v, i) => !argState.includes(v));
+  arr.length = 0;
+  pulled.forEach(v => arr.push(v));
+};
+
let myArray = ['a', 'b', 'c', 'a', 'b', 'c'];
+pull(myArray, 'a', 'c'); // myArray = [ 'b', 'b' ]
+

pullAtIndex

Mutates the original array to filter out the values at the specified indexes.

Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values. Use Array.push() to keep track of pulled values

const pullAtIndex = (arr, pullArr) => {
+  let removed = [];
+  let pulled = arr
+    .map((v, i) => (pullArr.includes(i) ? removed.push(v) : v))
+    .filter((v, i) => !pullArr.includes(i));
+  arr.length = 0;
+  pulled.forEach(v => arr.push(v));
+  return removed;
+};
+
let myArray = ['a', 'b', 'c', 'd'];
+let pulled = pullAtIndex(myArray, [1, 3]); // myArray = [ 'a', 'c' ] , pulled = [ 'b', 'd' ]
+

pullAtValue

Mutates the original array to filter out the values specified. Returns the removed elements.

Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values. Use Array.push() to keep track of pulled values

const pullAtValue = (arr, pullArr) => {
+  let removed = [],
+    pushToRemove = arr.forEach((v, i) => (pullArr.includes(v) ? removed.push(v) : v)),
+    mutateTo = arr.filter((v, i) => !pullArr.includes(v));
+  arr.length = 0;
+  mutateTo.forEach(v => arr.push(v));
+  return removed;
+};
+
let myArray = ['a', 'b', 'c', 'd'];
+let pulled = pullAtValue(myArray, ['b', 'd']); // myArray = [ 'a', 'c' ] , pulled = [ 'b', 'd' ]
+

pullByadvanced

Mutates the original array to filter out the values specified, based on a given iterator function.

Check if the last argument provided in a function. Use Array.map() to apply the iterator function fn to all array elements. Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values.

const pullBy = (arr, ...args) => {
+  const length = args.length;
+  let fn = length > 1 ? args[length - 1] : undefined;
+  fn = typeof fn == 'function' ? (args.pop(), fn) : undefined;
+  let argState = (Array.isArray(args[0]) ? args[0] : args).map(val => fn(val));
+  let pulled = arr.filter((v, i) => !argState.includes(fn(v)));
+  arr.length = 0;
+  pulled.forEach(v => arr.push(v));
+};
+
var myArray = [{ x: 1 }, { x: 2 }, { x: 3 }, { x: 1 }];
+pullBy(myArray, [{ x: 1 }, { x: 3 }], o => o.x); // myArray = [{ x: 2 }]
+

reducedFilter

Filter an array of objects based on a condition while also filtering out unspecified keys.

Use Array.filter() to filter the array based on the predicate fn so that it returns the objects for which the condition returned a truthy value. On the filtered array, use Array.map() to return the new object using Array.reduce() to filter out the keys which were not supplied as the keys argument.

const reducedFilter = (data, keys, fn) =>
+  data.filter(fn).map(el =>
+    keys.reduce((acc, key) => {
+      acc[key] = el[key];
+      return acc;
+    }, {})
+  );
+
const data = [
+  {
+    id: 1,
+    name: 'john',
+    age: 24
+  },
+  {
+    id: 2,
+    name: 'mike',
+    age: 50
+  }
+];
+
+reducedFilter(data, ['id', 'name'], item => item.age > 24); // [{ id: 2, name: 'mike'}]
+

reduceSuccessive

Applies a function against an accumulator and each element in the array (from left to right), returning an array of successively reduced values.

Use Array.reduce() to apply the given function to the given array, storing each new result.

const reduceSuccessive = (arr, fn, acc) =>
+  arr.reduce((res, val, i, arr) => (res.push(fn(res.slice(-1)[0], val, i, arr)), res), [acc]);
+
reduceSuccessive([1, 2, 3, 4, 5, 6], (acc, val) => acc + val, 0); // [0, 1, 3, 6, 10, 15, 21]
+

reduceWhich

Returns the minimum/maximum value of an array, after applying the provided function to set comparing rule.

Use Array.reduce() in combination with the comparator function to get the appropriate element in the array. You can omit the second parameter, comparator, to use the default one that returns the minimum element in the array.

const reduceWhich = (arr, comparator = (a, b) => a - b) =>
+  arr.reduce((a, b) => (comparator(a, b) >= 0 ? b : a));
+
reduceWhich([1, 3, 2]); // 1
+reduceWhich([1, 3, 2], (a, b) => b - a); // 3
+reduceWhich(
+  [{ name: 'Tom', age: 12 }, { name: 'Jack', age: 18 }, { name: 'Lucy', age: 9 }],
+  (a, b) => a.age - b.age
+); // {name: "Lucy", age: 9}
+

remove

Removes elements from an array for which the given function returns false.

Use Array.filter() to find array elements that return truthy values and Array.reduce() to remove elements using Array.splice(). The func is invoked with three arguments (value, index, array).

const remove = (arr, func) =>
+  Array.isArray(arr)
+    ? arr.filter(func).reduce((acc, val) => {
+        arr.splice(arr.indexOf(val), 1);
+        return acc.concat(val);
+      }, [])
+    : [];
+
remove([1, 2, 3, 4], n => n % 2 === 0); // [2, 4]
+

sample

Returns a random element from an array.

Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor(). This method also works with strings.

const sample = arr => arr[Math.floor(Math.random() * arr.length)];
+
sample([3, 7, 9, 11]); // 9
+

sampleSize

Gets n random elements at unique keys from array up to the size of array.

Shuffle the array using the Fisher-Yates algorithm. Use Array.slice() to get the first n elements. Omit the second argument, n to get only one element at random from the array.

const sampleSize = ([...arr], n = 1) => {
+  let m = arr.length;
+  while (m) {
+    const i = Math.floor(Math.random() * m--);
+    [arr[m], arr[i]] = [arr[i], arr[m]];
+  }
+  return arr.slice(0, n);
+};
+
sampleSize([1, 2, 3], 2); // [3,1]
+sampleSize([1, 2, 3], 4); // [2,3,1]
+

shuffle

Randomizes the order of the values of an array, returning a new array.

Uses the Fisher-Yates algorithm to reorder the elements of the array.

const shuffle = ([...arr]) => {
+  let m = arr.length;
+  while (m) {
+    const i = Math.floor(Math.random() * m--);
+    [arr[m], arr[i]] = [arr[i], arr[m]];
+  }
+  return arr;
+};
+
const foo = [1, 2, 3];
+shuffle(foo); // [2,3,1], foo = [1,2,3]
+

similarity

Returns an array of elements that appear in both arrays.

Use Array.filter() to remove values that are not part of values, determined using Array.includes().

const similarity = (arr, values) => arr.filter(v => values.includes(v));
+
similarity([1, 2, 3], [1, 2, 4]); // [1,2]
+

sortedIndex

Returns the lowest index at which value should be inserted into array in order to maintain its sort order.

Check if the array is sorted in descending order (loosely). Use Array.findIndex() to find the appropriate index where the element should be inserted.

const sortedIndex = (arr, n) => {
+  const isDescending = arr[0] > arr[arr.length - 1];
+  const index = arr.findIndex(el => (isDescending ? n >= el : n <= el));
+  return index === -1 ? arr.length : index;
+};
+
sortedIndex([5, 3, 2, 1], 4); // 1
+sortedIndex([30, 50], 40); // 1
+

sortedIndexBy

Returns the lowest index at which value should be inserted into array in order to maintain its sort order, based on a provided iterator function.

Check if the array is sorted in descending order (loosely). Use Array.findIndex() to find the appropriate index where the element should be inserted, based on the iterator function fn.

const sortedIndexBy = (arr, n, fn) => {
+  const isDescending = fn(arr[0]) > fn(arr[arr.length - 1]);
+  const val = fn(n);
+  const index = arr.findIndex(el => (isDescending ? val >= fn(el) : val <= fn(el)));
+  return index === -1 ? arr.length : index;
+};
+
sortedIndexBy([{ x: 4 }, { x: 5 }], { x: 4 }, o => o.x); // 0
+

sortedLastIndex

Returns the highest index at which value should be inserted into array in order to maintain its sort order.

Check if the array is sorted in descending order (loosely). Use Array.reverse() and Array.findIndex() to find the appropriate last index where the element should be inserted.

const sortedLastIndex = (arr, n) => {
+  const isDescending = arr[0] > arr[arr.length - 1];
+  const index = arr.reverse().findIndex(el => (isDescending ? n <= el : n >= el));
+  return index === -1 ? 0 : arr.length - index;
+};
+
sortedLastIndex([10, 20, 30, 30, 40], 30); // 4
+

sortedLastIndexBy

Returns the highest index at which value should be inserted into array in order to maintain its sort order, based on a provided iterator function.

Check if the array is sorted in descending order (loosely). Use Array.map() to apply the iterator function to all elements of the array. Use Array.reverse() and Array.findIndex() to find the appropriate last index where the element should be inserted, based on the provided iterator function.

const sortedLastIndexBy = (arr, n, fn) => {
+  const isDescending = fn(arr[0]) > fn(arr[arr.length - 1]);
+  const val = fn(n);
+  const index = arr
+    .map(fn)
+    .reverse()
+    .findIndex(el => (isDescending ? val <= el : val >= el));
+  return index === -1 ? 0 : arr.length - index;
+};
+
sortedLastIndexBy([{ x: 4 }, { x: 5 }], { x: 4 }, o => o.x); // 1
+

stableSortadvanced

Performs stable sorting of an array, preserving the initial indexes of items when their values are the same. Does not mutate the original array, but returns a new array instead.

Use Array.map() to pair each element of the input array with its corresponding index. Use Array.sort() and a compare function to sort the list, preserving their initial order if the items compared are equal. Use Array.map() to convert back to the initial array items.

const stableSort = (arr, compare) =>
+  arr
+    .map((item, index) => ({ item, index }))
+    .sort((a, b) => compare(a.item, b.item) || a.index - b.index)
+    .map(({ item }) => item);
+
const arr = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+const stable = stableSort(arr, () => 0); // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+

symmetricDifference

Returns the symmetric difference between two arrays.

Create a Set from each array, then use Array.filter() on each of them to only keep values not contained in the other.

const symmetricDifference = (a, b) => {
+  const sA = new Set(a),
+    sB = new Set(b);
+  return [...a.filter(x => !sB.has(x)), ...b.filter(x => !sA.has(x))];
+};
+
symmetricDifference([1, 2, 3], [1, 2, 4]); // [3,4]
+

symmetricDifferenceBy

Returns the symmetric difference between two arrays, after applying the provided function to each array element of both.

Create a Set by applying fn to each array's elements, then use Array.filter() on each of them to only keep values not contained in the other.

const symmetricDifferenceBy = (a, b, fn) => {
+  const sA = new Set(a.map(v => fn(v))),
+    sB = new Set(b.map(v => fn(v)));
+  return [...a.filter(x => !sB.has(fn(x))), ...b.filter(x => !sA.has(fn(x)))];
+};
+
symmetricDifferenceBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [ 1.2, 3.4 ]
+

symmetricDifferenceWith

Returns the symmetric difference between two arrays, using a provided function as a comparator.

Use Array.filter() and Array.findIndex() to find the appropriate values.

const symmetricDifferenceWith = (arr, val, comp) => [
+  ...arr.filter(a => val.findIndex(b => comp(a, b)) === -1),
+  ...val.filter(a => arr.findIndex(b => comp(a, b)) === -1)
+];
+
symmetricDifferenceWith(
+  [1, 1.2, 1.5, 3, 0],
+  [1.9, 3, 0, 3.9],
+  (a, b) => Math.round(a) === Math.round(b)
+); // [1, 1.2, 3.9]
+

tail

Returns all elements in an array except for the first one.

Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.

const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
+
tail([1, 2, 3]); // [2,3]
+tail([1]); // [1]
+

take

Returns an array with n elements removed from the beginning.

Use Array.slice() to create a slice of the array with n elements taken from the beginning.

const take = (arr, n = 1) => arr.slice(0, n);
+
take([1, 2, 3], 5); // [1, 2, 3]
+take([1, 2, 3], 0); // []
+

takeRight

Returns an array with n elements removed from the end.

Use Array.slice() to create a slice of the array with n elements taken from the end.

const takeRight = (arr, n = 1) => arr.slice(arr.length - n, arr.length);
+
takeRight([1, 2, 3], 2); // [ 2, 3 ]
+takeRight([1, 2, 3]); // [3]
+

takeRightWhile

Removes elements from the end of an array until the passed function returns true. Returns the removed elements.

Loop through the array, using a for...of loop over Array.keys() until the returned value from the function is true. Return the removed elements, using Array.reverse() and Array.slice().

const takeRightWhile = (arr, func) => {
+  for (let i of arr.reverse().keys())
+    if (func(arr[i])) return arr.reverse().slice(arr.length - i, arr.length);
+  return arr;
+};
+
takeRightWhile([1, 2, 3, 4], n => n < 3); // [3, 4]
+

takeWhile

Removes elements in an array until the passed function returns true. Returns the removed elements.

Loop through the array, using a for...of loop over Array.keys() until the returned value from the function is true. Return the removed elements, using Array.slice().

const takeWhile = (arr, func) => {
+  for (let i of arr.keys()) if (func(arr[i])) return arr.slice(0, i);
+  return arr;
+};
+
takeWhile([1, 2, 3, 4], n => n >= 3); // [1, 2]
+

union

Returns every element that exists in any of the two arrays once.

Create a Set with all values of a and b and convert to an array.

const union = (a, b) => Array.from(new Set([...a, ...b]));
+
union([1, 2, 3], [4, 3, 2]); // [1,2,3,4]
+

unionBy

Returns every element that exists in any of the two arrays once, after applying the provided function to each array element of both.

Create a Set by applying all fn to all values of a. Create a Set from a and all elements in b whose value, after applying fn does not match a value in the previously created set. Return the last set converted to an array.

const unionBy = (a, b, fn) => {
+  const s = new Set(a.map(v => fn(v)));
+  return Array.from(new Set([...a, ...b.filter(x => !s.has(fn(x)))]));
+};
+
unionBy([2.1], [1.2, 2.3], Math.floor); // [2.1, 1.2]
+

unionWith

Returns every element that exists in any of the two arrays once, using a provided comparator function.

Create a Set with all values of a and values in b for which the comparator finds no matches in a, using Array.findIndex().

const unionWith = (a, b, comp) =>
+  Array.from(new Set([...a, ...b.filter(x => a.findIndex(y => comp(x, y)) === -1)]));
+
unionWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0, 3.9], (a, b) => Math.round(a) === Math.round(b)); // [1, 1.2, 1.5, 3, 0, 3.9]
+

uniqueElements

Returns all unique values of an array.

Use ES6 Set and the ...rest operator to discard all duplicated values.

const uniqueElements = arr => [...new Set(arr)];
+
uniqueElements([1, 2, 2, 3, 4, 4, 5]); // [1,2,3,4,5]
+

unzip

Creates an array of arrays, ungrouping the elements in an array produced by zip.

Use Math.max.apply() to get the longest subarray in the array, Array.map() to make each element an array. Use Array.reduce() and Array.forEach() to map grouped values to individual arrays.

const unzip = arr =>
+  arr.reduce(
+    (acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
+    Array.from({
+      length: Math.max(...arr.map(x => x.length))
+    }).map(x => [])
+  );
+
unzip([['a', 1, true], ['b', 2, false]]); //[['a', 'b'], [1, 2], [true, false]]
+unzip([['a', 1, true], ['b', 2]]); //[['a', 'b'], [1, 2], [true]]
+

unzipWithadvanced

Creates an array of elements, ungrouping the elements in an array produced by zip and applying the provided function.

Use Math.max.apply() to get the longest subarray in the array, Array.map() to make each element an array. Use Array.reduce() and Array.forEach() to map grouped values to individual arrays. Use Array.map() and the spread operator (...) to apply fn to each individual group of elements.

const unzipWith = (arr, fn) =>
+  arr
+    .reduce(
+      (acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
+      Array.from({
+        length: Math.max(...arr.map(x => x.length))
+      }).map(x => [])
+    )
+    .map(val => fn(...val));
+
unzipWith([[1, 10, 100], [2, 20, 200]], (...args) => args.reduce((acc, v) => acc + v, 0)); // [3, 30, 300]
+

without

Filters out the elements of an array, that have one of the specified values.

Use Array.filter() to create an array excluding(using !Array.includes()) all given values.

(For a snippet that mutates the original array see pull)

const without = (arr, ...args) => arr.filter(v => !args.includes(v));
+
without([2, 1, 2, 3], 1, 2); // [3]
+

xProd

Creates a new array out of the two supplied by creating each possible pair from the arrays.

Use Array.reduce(), Array.map() and Array.concat() to produce every possible pair from the elements of the two arrays and save them in an array.

const xProd = (a, b) => a.reduce((acc, x) => acc.concat(b.map(y => [x, y])), []);
+
xProd([1, 2], ['a', 'b']); // [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
+

zip

Creates an array of elements, grouped based on the position in the original arrays.

Use Math.max.apply() to get the longest array in the arguments. Creates an array with that length as return value and use Array.from() with a map-function to create an array of grouped elements. If lengths of the argument-arrays vary, undefined is used where no value could be found.

const zip = (...arrays) => {
+  const maxLength = Math.max(...arrays.map(x => x.length));
+  return Array.from({ length: maxLength }).map((_, i) => {
+    return Array.from({ length: arrays.length }, (_, k) => arrays[k][i]);
+  });
+};
+
zip(['a', 'b'], [1, 2], [true, false]); // [['a', 1, true], ['b', 2, false]]
+zip(['a'], [1, 2], [true, false]); // [['a', 1, true], [undefined, 2, false]]
+

zipObject

Given an array of valid property identifiers and an array of values, return an object associating the properties to the values.

Since an object can have undefined values but not undefined property pointers, the array of properties is used to decide the structure of the resulting object using Array.reduce().

const zipObject = (props, values) =>
+  props.reduce((obj, prop, index) => ((obj[prop] = values[index]), obj), {});
+
zipObject(['a', 'b', 'c'], [1, 2]); // {a: 1, b: 2, c: undefined}
+zipObject(['a', 'b'], [1, 2, 3]); // {a: 1, b: 2}
+

zipWithadvanced

Creates an array of elements, grouped based on the position in the original arrays and using function as the last value to specify how grouped values should be combined.

Check if the last argument provided is a function. Use Math.max() to get the longest array in the arguments. Creates an array with that length as return value and use Array.from() with a map-function to create an array of grouped elements. If lengths of the argument-arrays vary, undefined is used where no value could be found. The function is invoked with the elements of each group (...group).

const zipWith = (...array) => {
+  const fn = typeof array[array.length - 1] === 'function' ? array.pop() : undefined;
+  return Array.from(
+    { length: Math.max(...array.map(a => a.length)) },
+    (_, i) => (fn ? fn(...array.map(a => a[i])) : array.map(a => a[i]))
+  );
+};
+
zipWith([1, 2], [10, 20], [100, 200], (a, b, c) => a + b + c); // [111,222]
+zipWith(
+  [1, 2, 3],
+  [10, 20],
+  [100, 200],
+  (a, b, c) => (a != null ? a : 'a') + (b != null ? b : 'b') + (c != null ? c : 'c')
+); // [111, 222, '3bc']
+
\ No newline at end of file diff --git a/docs/browser.html b/docs/browser.html new file mode 100644 index 000000000..4252896a6 --- /dev/null +++ b/docs/browser.html @@ -0,0 +1,337 @@ +Browser - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Browser

arrayToHtmlList

Converts the given array elements into <li> tags and appends them to the list of the given id.

Use Array.map() and document.querySelector() to create a list of html tags.

const arrayToHtmlList = (arr, listID) =>
+  arr.map(item => (document.querySelector('#' + listID).innerHTML += `<li>${item}</li>`));
+
arrayToHtmlList(['item 1', 'item 2'], 'myListID');
+

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
+  document.documentElement.clientHeight + window.scrollY >=
+  (document.documentElement.scrollHeight || document.documentElement.clientHeight);
+
bottomVisible(); // true
+

copyToClipboardadvanced

Copy a string to the clipboard. Only works as a result of user action (i.e. inside a click event listener).

Create a new <textarea> element, fill it with the supplied data and add it to the HTML document. Use Selection.getRangeAt()to store the selected range (if any). Use document.execCommand('copy') to copy to the clipboard. Remove the <textarea> element from the HTML document. Finally, use Selection().addRange() to recover the original selected range (if any).

const copyToClipboard = str => {
+  const el = document.createElement('textarea');
+  el.value = str;
+  el.setAttribute('readonly', '');
+  el.style.position = 'absolute';
+  el.style.left = '-9999px';
+  document.body.appendChild(el);
+  const selected =
+    document.getSelection().rangeCount > 0 ? document.getSelection().getRangeAt(0) : false;
+  el.select();
+  document.execCommand('copy');
+  document.body.removeChild(el);
+  if (selected) {
+    document.getSelection().removeAllRanges();
+    document.getSelection().addRange(selected);
+  }
+};
+
copyToClipboard('Lorem ipsum'); // 'Lorem ipsum' copied to clipboard.
+

createElement

Creates an element from a string (without appending it to the document). If the given string contains multiple elements, only the first one will be returned.

Use document.createElement() to create a new element. Set its innerHTML to the string supplied as the argument. Use ParentNode.firstElementChild to return the element version of the string.

const createElement = str => {
+  const el = document.createElement('div');
+  el.innerHTML = str;
+  return el.firstElementChild;
+};
+
const el = createElement(
+  `<div class="container">
+    <p>Hello!</p>
+  </div>`
+);
+console.log(el.className); // 'container'
+

createEventHubadvanced

Creates a pub/sub (publish–subscribe) event hub with emit, on, and off methods.

Use Object.create(null) to create an empty hub object that does not inherit properties from Object.prototype. For emit, resolve the array of handlers based on the event argument and then run each one with Array.forEach() by passing in the data as an argument. For on, create an array for the event if it does not yet exist, then use Array.push() to add the handler to the array. For off, use Array.findIndex() to find the index of the handler in the event array and remove it using Array.splice().

const createEventHub = () => ({
+  hub: Object.create(null),
+  emit(event, data) {
+    (this.hub[event] || []).forEach(handler => handler(data));
+  },
+  on(event, handler) {
+    if (!this.hub[event]) this.hub[event] = [];
+    this.hub[event].push(handler);
+  },
+  off(event, handler) {
+    const i = (this.hub[event] || []).findIndex(h => h === handler);
+    if (i > -1) this.hub[event].splice(i, 1);
+  }
+});
+
const handler = data => console.log(data);
+const hub = createEventHub();
+let increment = 0;
+
+// Subscribe: listen for different types of events
+hub.on('message', handler);
+hub.on('message', () => console.log('Message event fired'));
+hub.on('increment', () => increment++);
+
+// Publish: emit events to invoke all handlers subscribed to them, passing the data to them as an argument
+hub.emit('message', 'hello world'); // logs 'hello world' and 'Message event fired'
+hub.emit('message', { hello: 'world' }); // logs the object and 'Message event fired'
+hub.emit('increment'); // `increment` variable is now 1
+
+// Unsubscribe: stop a specific handler from listening to the 'message' event
+hub.off('message', handler);
+

currentURL

Returns the current URL.

Use window.location.href to get current URL.

const currentURL = () => window.location.href;
+
currentURL(); // 'https://google.com'
+

detectDeviceType

Detects wether the website is being opened in a mobile device or a desktop/laptop.

Use a regular expression to test the navigator.userAgent property to figure out if the device is a mobile device or a desktop/laptop.

const detectDeviceType = () =>
+  /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent)
+    ? 'Mobile'
+    : 'Desktop';
+
detectDeviceType(); // "Mobile" or "Desktop"
+

elementIsVisibleInViewport

Returns true if the element specified is visible in the viewport, false otherwise.

Use Element.getBoundingClientRect() and the window.inner(Width|Height) values to determine if a given element is visible in the viewport. Omit the second argument to determine if the element is entirely visible, or specify true to determine if it is partially visible.

const elementIsVisibleInViewport = (el, partiallyVisible = false) => {
+  const { top, left, bottom, right } = el.getBoundingClientRect();
+  const { innerHeight, innerWidth } = window;
+  return partiallyVisible
+    ? ((top > 0 && top < innerHeight) || (bottom > 0 && bottom < innerHeight)) &&
+        ((left > 0 && left < innerWidth) || (right > 0 && right < innerWidth))
+    : top >= 0 && left >= 0 && bottom <= innerHeight && right <= innerWidth;
+};
+
// e.g. 100x100 viewport and a 10x10px element at position {top: -1, left: 0, bottom: 9, right: 10}
+elementIsVisibleInViewport(el); // false - (not fully visible)
+elementIsVisibleInViewport(el, true); // true - (partially visible)
+

getScrollPosition

Returns the scroll position of the current page.

Use pageXOffset and pageYOffset if they are defined, otherwise scrollLeft and scrollTop. You can omit el to use a default value of window.

const getScrollPosition = (el = window) => ({
+  x: el.pageXOffset !== undefined ? el.pageXOffset : el.scrollLeft,
+  y: el.pageYOffset !== undefined ? el.pageYOffset : el.scrollTop
+});
+
getScrollPosition(); // {x: 0, y: 200}
+

getStyle

Returns the value of a CSS rule for the specified element.

Use Window.getComputedStyle() to get the value of the CSS rule for the specified element.

const getStyle = (el, ruleName) => getComputedStyle(el)[ruleName];
+
getStyle(document.querySelector('p'), 'font-size'); // '16px'
+

hasClass

Returns true if the element has the specified class, false otherwise.

Use element.classList.contains() to check if the element has the specified class.

const hasClass = (el, className) => el.classList.contains(className);
+
hasClass(document.querySelector('p.special'), 'special'); // true
+

hashBrowseradvanced

Creates a hash for a value using the SHA-256 algorithm. Returns a promise.

Use the SubtleCrypto API to create a hash for the given value.

const hashBrowser = val =>
+  crypto.subtle.digest('SHA-256', new TextEncoder('utf-8').encode(val)).then(h => {
+    let hexes = [],
+      view = new DataView(h);
+    for (let i = 0; i < view.byteLength; i += 4)
+      hexes.push(('00000000' + view.getUint32(i).toString(16)).slice(-8));
+    return hexes.join('');
+  });
+
hashBrowser(JSON.stringify({ a: 'a', b: [1, 2, 3, 4], foo: { c: 'bar' } })).then(console.log); // '04aa106279f5977f59f9067fa9712afc4aedc6f5862a8defc34552d8c7206393'
+

hide

Hides all the elements specified.

Use the spread operator (...) and Array.forEach() to apply display: none to each element specified.

const hide = (...el) => [...el].forEach(e => (e.style.display = 'none'));
+
hide(...document.querySelectorAll('img')); // Hides all <img> elements on the page
+

httpsRedirect

Redirects the page to HTTPS if its currently in HTTP. Also, pressing the back button doesn't take it back to the HTTP page as its replaced in the history.

Use location.protocol to get the protocol currently being used. If it's not HTTPS, use location.replace() to replace the existing page with the HTTPS version of the page. Use location.href to get the full address, split it with String.split() and remove the protocol part of the URL.

const httpsRedirect = () => {
+  if (location.protocol !== 'https:') location.replace('https://' + location.href.split('//')[1]);
+};
+
httpsRedirect(); // If you are on http://mydomain.com, you are redirected to https://mydomain.com
+

observeMutationsadvanced

Returns a new MutationObserver and runs the provided callback for each mutation on the specified element.

Use a MutationObserver to observe mutations on the given element. Use Array.forEach() to run the callback for each mutation that is observed. Omit the third argument, options, to use the default options (all true).

const observeMutations = (element, callback, options) => {
+  const observer = new MutationObserver(mutations => mutations.forEach(m => callback(m)));
+  observer.observe(
+    element,
+    Object.assign(
+      {
+        childList: true,
+        attributes: true,
+        attributeOldValue: true,
+        characterData: true,
+        characterDataOldValue: true,
+        subtree: true
+      },
+      options
+    )
+  );
+  return observer;
+};
+
const obs = observeMutations(document, console.log); // Logs all mutations that happen on the page
+obs.disconnect(); // Disconnects the observer and stops logging mutations on the page
+

off

Removes an event listener from an element.

Use EventTarget.removeEventListener() to remove an event listener from an element. Omit the fourth argument opts to use false or specify it based on the options used when the event listener was added.

const off = (el, evt, fn, opts = false) => el.removeEventListener(evt, fn, opts);
+
const fn = () => console.log('!');
+document.body.addEventListener('click', fn);
+off(document.body, 'click', fn); // no longer logs '!' upon clicking on the page
+

on

Adds an event listener to an element with the ability to use event delegation.

Use EventTarget.addEventListener() to add an event listener to an element. If there is a target property supplied to the options object, ensure the event target matches the target specified and then invoke the callback by supplying the correct this context. Returns a reference to the custom delegator function, in order to be possible to use with off. Omit opts to default to non-delegation behavior and event bubbling.

const on = (el, evt, fn, opts = {}) => {
+  const delegatorFn = e => e.target.matches(opts.target) && fn.call(e.target, e);
+  el.addEventListener(evt, opts.target ? delegatorFn : fn, opts.options || false);
+  if (opts.target) return delegatorFn;
+};
+
const fn = () => console.log('!');
+on(document.body, 'click', fn); // logs '!' upon clicking the body
+on(document.body, 'click', fn, { target: 'p' }); // logs '!' upon clicking a `p` element child of the body
+on(document.body, 'click', fn, { options: true }); // use capturing instead of bubbling
+

onUserInputChangeadvanced

Run the callback whenever the user input type changes (mouse or touch). Useful for enabling/disabling code depending on the input device. This process is dynamic and works with hybrid devices (e.g. touchscreen laptops).

Use two event listeners. Assume mouse input initially and bind a touchstart event listener to the document. On touchstart, add a mousemove event listener to listen for two consecutive mousemove events firing within 20ms, using performance.now(). Run the callback with the input type as an argument in either of these situations.

const onUserInputChange = callback => {
+  let type = 'mouse',
+    lastTime = 0;
+  const mousemoveHandler = () => {
+    const now = performance.now();
+    if (now - lastTime < 20)
+      (type = 'mouse'), callback(type), document.removeEventListener('mousemove', mousemoveHandler);
+    lastTime = now;
+  };
+  document.addEventListener('touchstart', () => {
+    if (type === 'touch') return;
+    (type = 'touch'), callback(type), document.addEventListener('mousemove', mousemoveHandler);
+  });
+};
+
onUserInputChange(type => {
+  console.log('The user is now using', type, 'as an input method.');
+});
+

prefix

Returns the prefixed version (if necessary) of a CSS property that the browser supports.

Use Array.findIndex() on an array of vendor prefix strings to test if document.body has one of them defined in its CSSStyleDeclaration object, otherwise return null. Use String.charAt() and String.toUpperCase() to capitalize the property, which will be appended to the vendor prefix string.

const prefix = prop => {
+  const capitalizedProp = prop.charAt(0).toUpperCase() + prop.slice(1);
+  const prefixes = ['', 'webkit', 'moz', 'ms', 'o'];
+  const i = prefixes.findIndex(
+    prefix => typeof document.body.style[prefix ? prefix + capitalizedProp : prop] !== 'undefined'
+  );
+  return i !== -1 ? (i === 0 ? prop : prefixes[i] + capitalizedProp) : null;
+};
+
prefix('appearance'); // 'appearance' on a supported browser, otherwise 'webkitAppearance', 'mozAppearance', 'msAppearance' or 'oAppearance'
+

recordAnimationFrames

Invokes the provided callback on each animation frame.

Use recursion. Provided that running is true, continue invoking window.requestAnimationFrame() which invokes the provided callback. Return an object with two methods start and stop to allow manual control of the recording. Omit the second argument, autoStart, to implicitly call start when the function is invoked.

const recordAnimationFrames = (callback, autoStart = true) => {
+  let running = true,
+    raf;
+  const stop = () => {
+    running = false;
+    cancelAnimationFrame(raf);
+  };
+  const start = () => {
+    running = true;
+    run();
+  };
+  const run = () => {
+    raf = requestAnimationFrame(() => {
+      callback();
+      if (running) run();
+    });
+  };
+  if (autoStart) start();
+  return { start, stop };
+};
+
const cb = () => console.log('Animation frame fired');
+const recorder = recordAnimationFrames(cb); // logs 'Animation frame fired' on each animation frame
+recorder.stop(); // stops logging
+recorder.start(); // starts again
+const recorder2 = recordAnimationFrames(cb, false); // `start` needs to be explicitly called to begin recording frames
+

redirect

Redirects to a specified URL.

Use window.location.href or window.location.replace() to redirect to url. Pass a second argument to simulate a link click (true - default) or an HTTP redirect (false).

const redirect = (url, asLink = true) =>
+  asLink ? (window.location.href = url) : window.location.replace(url);
+
redirect('https://google.com');
+

runAsyncadvanced

Runs a function in a separate thread by using a Web Worker, allowing long running functions to not block the UI.

Create a new Worker using a Blob object URL, the contents of which should be the stringified version of the supplied function. Immediately post the return value of calling the function back. Return a promise, listening for onmessage and onerror events and resolving the data posted back from the worker, or throwing an error.

const runAsync = fn => {
+  const worker = new Worker(
+    URL.createObjectURL(new Blob([`postMessage((${fn})());`]), {
+      type: 'application/javascript; charset=utf-8'
+    })
+  );
+  return new Promise((res, rej) => {
+    worker.onmessage = ({ data }) => {
+      res(data), worker.terminate();
+    };
+    worker.onerror = err => {
+      rej(err), worker.terminate();
+    };
+  });
+};
+
const longRunningFunction = () => {
+  let result = 0;
+  for (let i = 0; i < 1000; i++) {
+    for (let j = 0; j < 700; j++) {
+      for (let k = 0; k < 300; k++) {
+        result = result + i + j + k;
+      }
+    }
+  }
+  return result;
+};
+/*
+  NOTE: Since the function is running in a different context, closures are not supported.
+  The function supplied to `runAsync` gets stringified, so everything becomes literal.
+  All variables and functions must be defined inside.
+*/
+runAsync(longRunningFunction).then(console.log); // 209685000000
+runAsync(() => 10 ** 3).then(console.log); // 1000
+let outsideVariable = 50;
+runAsync(() => typeof outsideVariable).then(console.log); // 'undefined'
+

scrollToTop

Smooth-scrolls to the top of the page.

Get distance from top using document.documentElement.scrollTop or document.body.scrollTop. Scroll by a fraction of the distance from the top. Use window.requestAnimationFrame() to animate the scrolling.

const scrollToTop = () => {
+  const c = document.documentElement.scrollTop || document.body.scrollTop;
+  if (c > 0) {
+    window.requestAnimationFrame(scrollToTop);
+    window.scrollTo(0, c - c / 8);
+  }
+};
+
scrollToTop();
+

setStyle

Sets the value of a CSS rule for the specified element.

Use element.style to set the value of the CSS rule for the specified element to val.

const setStyle = (el, ruleName, val) => (el.style[ruleName] = val);
+
setStyle(document.querySelector('p'), 'font-size', '20px'); // The first <p> element on the page will have a font-size of 20px
+

show

Shows all the elements specified.

Use the spread operator (...) and Array.forEach() to clear the display property for each element specified.

const show = (...el) => [...el].forEach(e => (e.style.display = ''));
+
show(...document.querySelectorAll('img')); // Shows all <img> elements on the page
+

smoothScroll

Smoothly scrolls the element on which it's called into the visible area of the browser window.

Use .scrollIntoView method to scroll the element. Pass { behavior: 'smooth' } to .scrollIntoView so it scrolls smoothly.

const smoothScroll = element =>
+  document.querySelector(element).scrollIntoView({
+    behavior: 'smooth'
+  });
+
smoothScroll('#fooBar'); // scrolls smoothly to the element with the id fooBar
+smoothScroll('.fooBar'); // scrolls smoothly to the first element with a class of fooBar
+

toggleClass

Toggle a class for an element.

Use element.classList.toggle() to toggle the specified class for the element.

const toggleClass = (el, className) => el.classList.toggle(className);
+
toggleClass(document.querySelector('p.special'), 'special'); // The paragraph will not have the 'special' class anymore
+

UUIDGeneratorBrowser

Generates a UUID in a browser.

Use crypto API to generate a UUID, compliant with RFC4122 version 4.

const UUIDGeneratorBrowser = () =>
+  ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c =>
+    (c ^ (crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (c / 4)))).toString(16)
+  );
+
UUIDGeneratorBrowser(); // '7982fcfe-5721-4632-bede-6000885be57d'
+
\ No newline at end of file diff --git a/docs/date.html b/docs/date.html new file mode 100644 index 000000000..ea628afd9 --- /dev/null +++ b/docs/date.html @@ -0,0 +1,121 @@ +Date - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Date

formatDuration

Returns the human readable format of the given number of milliseconds.

Divide ms with the appropriate values to obtain the appropriate values for day, hour, minute, second and millisecond. Use Object.entries() with Array.filter() to keep only non-zero values. Use Array.map() to create the string for each value, pluralizing appropriately. Use String.join(', ') to combine the values into a string.

const formatDuration = ms => {
+  if (ms < 0) ms = -ms;
+  const time = {
+    day: Math.floor(ms / 86400000),
+    hour: Math.floor(ms / 3600000) % 24,
+    minute: Math.floor(ms / 60000) % 60,
+    second: Math.floor(ms / 1000) % 60,
+    millisecond: Math.floor(ms) % 1000
+  };
+  return Object.entries(time)
+    .filter(val => val[1] !== 0)
+    .map(val => val[1] + ' ' + (val[1] !== 1 ? val[0] + 's' : val[0]))
+    .join(', ');
+};
+
formatDuration(1001); // '1 second, 1 millisecond'
+formatDuration(34325055574); // '397 days, 6 hours, 44 minutes, 15 seconds, 574 milliseconds'
+

getColonTimeFromDate

Returns a string of the form HH:MM:SS from a Date object.

Use Date.toString() and String.slice() to get the HH:MM:SS part of a given Date object.

const getColonTimeFromDate = date => date.toTimeString().slice(0, 8);
+
getColonTimeFromDate(new Date()); // "08:38:00"
+

getDaysDiffBetweenDates

Returns the difference (in days) between two dates.

Calculate the difference (in days) between two Date objects.

const getDaysDiffBetweenDates = (dateInitial, dateFinal) =>
+  (dateFinal - dateInitial) / (1000 * 3600 * 24);
+
getDaysDiffBetweenDates(new Date('2017-12-13'), new Date('2017-12-22')); // 9
+

getMeridiemSuffixOfInteger

Converts an integer to a suffixed string, adding am or pm based on its value.

Use the modulo operator (%) and conditional checks to transform an integer to a stringified 12-hour format with meridiem suffix.

const getMeridiemSuffixOfInteger = num =>
+  num === 0 || num === 24
+    ? 12 + 'am'
+    : num === 12 ? 12 + 'pm' : num < 12 ? num % 12 + 'am' : num % 12 + 'pm';
+
getMeridiemSuffixOfInteger(0); // "12am"
+getMeridiemSuffixOfInteger(11); // "11am"
+getMeridiemSuffixOfInteger(13); // "1pm"
+getMeridiemSuffixOfInteger(25); // "1pm"
+

tomorrow

Results in a string representation of tomorrow's date. Use new Date() to get today's date, adding one day using Date.getDate() and Date.setDate(), and converting the Date object to a string.

const tomorrow = (long = false) => {
+  let t = new Date();
+  t.setDate(t.getDate() + 1);
+  const ret = `${t.getFullYear()}-${String(t.getMonth() + 1).padStart(2, '0')}-${String(
+    t.getDate()
+  ).padStart(2, '0')}`;
+  return !long ? ret : `${ret}T00:00:00`;
+};
+
tomorrow(); // 2017-12-27 (if current date is 2017-12-26)
+tomorrow(true); // 2017-12-27T00:00:00 (if current date is 2017-12-26)
+
\ No newline at end of file diff --git a/docs/function.html b/docs/function.html new file mode 100644 index 000000000..50f9a98c7 --- /dev/null +++ b/docs/function.html @@ -0,0 +1,275 @@ +Function - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Function

attempt

Attempts to invoke a function with the provided arguments, returning either the result or the caught error object.

Use a try... catch block to return either the result of the function or an appropriate error.

const attempt = (fn, ...args) => {
+  try {
+    return fn(...args);
+  } catch (e) {
+    return e instanceof Error ? e : new Error(e);
+  }
+};
+
var elements = attempt(function(selector) {
+  return document.querySelectorAll(selector);
+}, '>_>');
+if (elements instanceof Error) elements = []; // elements = []
+

bind

Creates a function that invokes fn with a given context, optionally adding any additional supplied parameters to the beginning of the arguments.

Return a function that uses Function.apply() to apply the given context to fn. Use Array.concat() to prepend any additional supplied parameters to the arguments.

const bind = (fn, context, ...args) =>
+  function() {
+    return fn.apply(context, args.concat(...arguments));
+  };
+
function greet(greeting, punctuation) {
+  return greeting + ' ' + this.user + punctuation;
+}
+const freddy = { user: 'fred' };
+const freddyBound = bind(greet, freddy);
+console.log(freddyBound('hi', '!')); // 'hi fred!'
+

bindKey

Creates a function that invokes the method at a given key of an object, optionally adding any additional supplied parameters to the beginning of the arguments.

Return a function that uses Function.apply() to bind context[fn] to context. Use Array.concat() to prepend any additional supplied parameters to the arguments.

const bindKey = (context, fn, ...args) =>
+  function() {
+    return context[fn].apply(context, args.concat(...arguments));
+  };
+
const freddy = {
+  user: 'fred',
+  greet: function(greeting, punctuation) {
+    return greeting + ' ' + this.user + punctuation;
+  }
+};
+const freddyBound = bindKey(freddy, 'greet');
+console.log(freddyBound('hi', '!')); // 'hi fred!'
+

chainAsync

Chains asynchronous functions.

Loop through an array of functions containing asynchronous events, calling next when each asynchronous event has completed.

const chainAsync = fns => {
+  let curr = 0;
+  const next = () => fns[curr++](next);
+  next();
+};
+
chainAsync([
+  next => {
+    console.log('0 seconds');
+    setTimeout(next, 1000);
+  },
+  next => {
+    console.log('1 second');
+  }
+]);
+

compose

Performs right-to-left function composition.

Use Array.reduce() to perform right-to-left function composition. The last (rightmost) function can accept one or more arguments; the remaining functions must be unary.

const compose = (...fns) => fns.reduce((f, g) => (...args) => f(g(...args)));
+
const add5 = x => x + 5;
+const multiply = (x, y) => x * y;
+const multiplyAndAdd5 = compose(add5, multiply);
+multiplyAndAdd5(5, 2); // 15
+

composeRight

Performs left-to-right function composition.

Use Array.reduce() to perform left-to-right function composition. The first (leftmost) function can accept one or more arguments; the remaining functions must be unary.

const composeRight = (...fns) => fns.reduce((f, g) => (...args) => g(f(...args)));
+
const add = (x, y) => x + y;
+const square = x => x * x;
+const addAndSquare = composeRight(add, square);
+addAndSquare(1, 2); // 9
+

converge

Accepts a converging function and a list of branching functions and returns a function that applies each branching function to the arguments and the results of the branching functions are passed as arguments to the converging function.

Use Array.map() and Function.apply() to apply each function to the given arguments. Use the spread operator (...) to call coverger with the results of all other functions.

const converge = (converger, fns) => (...args) => converger(...fns.map(fn => fn.apply(null, args)));
+
const average = converge((a, b) => a / b, [
+  arr => arr.reduce((a, v) => a + v, 0),
+  arr => arr.length
+]);
+average([1, 2, 3, 4, 5, 6, 7]); // 4
+

curry

Curries a function.

Use recursion. If the number of provided arguments (args) is sufficient, call the passed function fn. Otherwise, return a curried function fn that expects the rest of the arguments. If you want to curry a function that accepts a variable number of arguments (a variadic function, e.g. Math.min()), you can optionally pass the number of arguments to the second parameter arity.

const curry = (fn, arity = fn.length, ...args) =>
+  arity <= args.length ? fn(...args) : curry.bind(null, fn, arity, ...args);
+
curry(Math.pow)(2)(10); // 1024
+curry(Math.min, 3)(10)(50)(2); // 2
+

debounce

Creates a debounced function that delays invoking the provided function until at least ms milliseconds have elapsed since the last time it was invoked.

Each time the debounced function is invoked, clear the current pending timeout with clearTimeout() and use setTimeout() to create a new timeout that delays invoking the function until at least ms milliseconds has elapsed. Use Function.apply() to apply the this context to the function and provide the necessary arguments. Omit the second argument, ms, to set the timeout at a default of 0 ms.

const debounce = (fn, ms = 0) => {
+  let timeoutId;
+  return function(...args) {
+    clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => fn.apply(this, args), ms);
+  };
+};
+
window.addEventListener(
+  'resize',
+  debounce(() => {
+    console.log(window.innerWidth);
+    console.log(window.innerHeight);
+  }, 250)
+); // Will log the window dimensions at most every 250ms
+

defer

Defers invoking a function until the current call stack has cleared.

Use setTimeout() with a timeout of 1ms to add a new event to the browser event queue and allow the rendering engine to complete its work. Use the spread (...) operator to supply the function with an arbitrary number of arguments.

const defer = (fn, ...args) => setTimeout(fn, 1, ...args);
+
// Example A:
+defer(console.log, 'a'), console.log('b'); // logs 'b' then 'a'
+
+// Example B:
+document.querySelector('#someElement').innerHTML = 'Hello';
+longRunningFunction(); //Browser will not update the HTML until this has finished
+defer(longRunningFunction); // Browser will update the HTML then run the function
+

delay

Invokes the provided function after wait milliseconds.

Use setTimeout() to delay execution of fn. Use the spread (...) operator to supply the function with an arbitrary number of arguments.

const delay = (fn, wait, ...args) => setTimeout(fn, wait, ...args);
+
delay(
+  function(text) {
+    console.log(text);
+  },
+  1000,
+  'later'
+); // Logs 'later' after one second.
+

functionName

Logs the name of a function.

Use console.debug() and the name property of the passed method to log the method's name to the debug channel of the console.

const functionName = fn => (console.debug(fn.name), fn);
+
functionName(Math.max); // max (logged in debug channel of console)
+

memoize

Returns the memoized (cached) function.

Create an empty cache by instantiating a new Map object. Return a function which takes a single argument to be supplied to the memoized function by first checking if the function's output for that specific input value is already cached, or store and return it if not. The function keyword must be used in order to allow the memoized function to have its this context changed if necessary. Allow access to the cache by setting it as a property on the returned function.

const memoize = fn => {
+  const cache = new Map();
+  const cached = function(val) {
+    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val);
+  };
+  cached.cache = cache;
+  return cached;
+};
+
// See the `anagrams` snippet.
+const anagramsCached = memoize(anagrams);
+anagramsCached('javascript'); // takes a long time
+anagramsCached('javascript'); // returns virtually instantly since it's now cached
+console.log(anagramsCached.cache); // The cached anagrams map
+

negate

Negates a predicate function.

Take a predicate function and apply the not operator (!) to it with its arguments.

const negate = func => (...args) => !func(...args);
+
[1, 2, 3, 4, 5, 6].filter(negate(n => n % 2 === 0)); // [ 1, 3, 5 ]
+

once

Ensures a function is called only once.

Utilizing a closure, use a flag, called, and set it to true once the function is called for the first time, preventing it from being called again. In order to allow the function to have its this context changed (such as in an event listener), the function keyword must be used, and the supplied function must have the context applied. Allow the function to be supplied with an arbitrary number of arguments using the rest/spread (...) operator.

const once = fn => {
+  let called = false;
+  return function(...args) {
+    if (called) return;
+    called = true;
+    return fn.apply(this, args);
+  };
+};
+
const startApp = function(event) {
+  console.log(this, event); // document.body, MouseEvent
+};
+document.body.addEventListener('click', once(startApp)); // only runs `startApp` once upon click
+

partial

Creates a function that invokes fn with partials prepended to the arguments it receives.

Use the spread operator (...) to prepend partials to the list of arguments of fn.

const partial = (fn, ...partials) => (...args) => fn(...partials, ...args);
+
const greet = (greeting, name) => greeting + ' ' + name + '!';
+const greetHello = partial(greet, 'Hello');
+greetHello('John'); // 'Hello John!'
+

partialRight

Creates a function that invokes fn with partials appended to the arguments it receives.

Use the spread operator (...) to append partials to the list of arguments of fn.

const partialRight = (fn, ...partials) => (...args) => fn(...args, ...partials);
+
const greet = (greeting, name) => greeting + ' ' + name + '!';
+const greetJohn = partialRight(greet, 'John');
+greetJohn('Hello'); // 'Hello John!'
+

runPromisesInSeries

Runs an array of promises in series.

Use Array.reduce() to create a promise chain, where each promise returns the next promise when resolved.

const runPromisesInSeries = ps => ps.reduce((p, next) => p.then(next), Promise.resolve());
+
const delay = d => new Promise(r => setTimeout(r, d));
+runPromisesInSeries([() => delay(1000), () => delay(2000)]); // Executes each promise sequentially, taking a total of 3 seconds to complete
+

sleep

Delays the execution of an asynchronous function.

Delay executing part of an async function, by putting it to sleep, returning a Promise.

const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
+
async function sleepyWork() {
+  console.log("I'm going to sleep for 1 second.");
+  await sleep(1000);
+  console.log('I woke up after 1 second.');
+}
+

throttle

Creates a throttled function that only invokes the provided function at most once per every wait milliseconds

Use setTimeout() and clearTimeout() to throttle the given method, fn. Use Function.apply() to apply the this context to the function and provide the necessary arguments. Use Date.now() to keep track of the last time the throttled function was invoked. Omit the second argument, wait, to set the timeout at a default of 0 ms.

const throttle = (fn, wait) => {
+  let inThrottle, lastFn, lastTime;
+  return function() {
+    const context = this,
+      args = arguments;
+    if (!inThrottle) {
+      fn.apply(context, args);
+      lastTime = Date.now();
+      inThrottle = true;
+    } else {
+      clearTimeout(lastFn);
+      lastFn = setTimeout(function() {
+        if (Date.now() - lastTime >= wait) {
+          fn.apply(context, args);
+          lastTime = Date.now();
+        }
+      }, wait - (Date.now() - lastTime));
+    }
+  };
+};
+
window.addEventListener(
+  'resize',
+  throttle(function(evt) {
+    console.log(window.innerWidth);
+    console.log(window.innerHeight);
+  }, 250)
+); // Will log the window dimensions at most every 250ms
+

times

Iterates over a callback n times

Use Function.call() to call fn n times or until it returns false. Omit the last argument, context, to use an undefined object (or the global object in non-strict mode).

const times = (n, fn, context = undefined) => {
+  let i = 0;
+  while (fn.call(context, i) !== false && ++i < n) {}
+};
+
var output = '';
+times(5, i => (output += i));
+console.log(output); // 01234
+

uncurry

Uncurries a function up to depth n.

Return a variadic function. Use Array.reduce() on the provided arguments to call each subsequent curry level of the function. If the length of the provided arguments is less than n throw an error. Otherwise, call fn with the proper amount of arguments, using Array.slice(0, n). Omit the second argument, n, to uncurry up to depth 1.

const uncurry = (fn, n = 1) => (...args) => {
+  const next = acc => args => args.reduce((x, y) => x(y), acc);
+  if (n > args.length) throw new RangeError('Arguments too few!');
+  return next(fn)(args.slice(0, n));
+};
+
const add = x => y => z => x + y + z;
+const uncurriedAdd = uncurry(add, 3);
+uncurriedAdd(1, 2, 3); // 6
+

unfold

Builds an array, using an iterator function and an initial seed value.

Use a while loop and Array.push() to call the function repeatedly until it returns false. The iterator function accepts one argument (seed) and must always return an array with two elements ([value, nextSeed]) or false to terminate.

const unfold = (fn, seed) => {
+  let result = [],
+    val = [null, seed];
+  while ((val = fn(val[1]))) result.push(val[0]);
+  return result;
+};
+
var f = n => (n > 50 ? false : [-n, n + 10]);
+unfold(f, 10); // [-10, -20, -30, -40, -50]
+
\ No newline at end of file diff --git a/docs/math.html b/docs/math.html new file mode 100644 index 000000000..d3b5ab234 --- /dev/null +++ b/docs/math.html @@ -0,0 +1,278 @@ +Math - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Math

approximatelyEqual

Checks if two numbers are approximately equal to each other.

Use Math.abs() to compare the absolute difference of the two values to epsilon. Omit the third parameter, epsilon, to use a default value of 0.001.

const approximatelyEqual = (v1, v2, epsilon = 0.001) => Math.abs(v1 - v2) < epsilon;
+
approximatelyEqual(Math.PI / 2.0, 1.5708); // true
+

average

Returns the average of two or more numbers.

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0, divide by the length of the array.

const average = (...nums) => [...nums].reduce((acc, val) => acc + val, 0) / nums.length;
+
average(...[1, 2, 3]); // 2
+average(1, 2, 3); // 2
+

averageBy

Returns the average of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Array.reduce() to add each value to an accumulator, initialized with a value of 0, divide by the length of the array.

const averageBy = (arr, fn) =>
+  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val) => acc + val, 0) /
+  arr.length;
+
averageBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 5
+averageBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 5
+

binomialCoefficient

Evaluates the binomial coefficient of two integers n and k.

Use Number.isNaN() to check if any of the two values is NaN. Check if k is less than 0, greater than or equal to n, equal to 1 or n - 1 and return the appropriate result. Check if n - k is less than k and switch their values accordingly. Loop from 2 through k and calculate the binomial coefficient. Use Math.round() to account for rounding errors in the calculation.

const binomialCoefficient = (n, k) => {
+  if (Number.isNaN(n) || Number.isNaN(k)) return NaN;
+  if (k < 0 || k > n) return 0;
+  if (k === 0 || k === n) return 1;
+  if (k === 1 || k === n - 1) return n;
+  if (n - k < k) k = n - k;
+  let res = n;
+  for (let j = 2; j <= k; j++) res *= (n - j + 1) / j;
+  return Math.round(res);
+};
+
binomialCoefficient(8, 2); // 28
+

clampNumber

Clamps num within the inclusive range specified by the boundary values a and b.

If num falls within the range, return num. Otherwise, return the nearest number in the range.

const clampNumber = (num, a, b) => Math.max(Math.min(num, Math.max(a, b)), Math.min(a, b));
+
clampNumber(2, 3, 5); // 3
+clampNumber(1, -1, -5); // -1
+

degreesToRads

Converts an angle from degrees to radians.

Use Math.PI and the degree to radian formula to convert the angle from degrees to radians.

const degreesToRads = deg => deg * Math.PI / 180.0;
+
degreesToRads(90.0); // ~1.5708
+

digitize

Converts a number to an array of digits.

Convert the number to a string, using the spread operator (...) to build an array. Use Array.map() and parseInt() to transform each value to an integer.

const digitize = n => [...`${n}`].map(i => parseInt(i));
+
digitize(123); // [1, 2, 3]
+

distance

Returns the distance between two points.

Use Math.hypot() to calculate the Euclidean distance between two points.

const distance = (x0, y0, x1, y1) => Math.hypot(x1 - x0, y1 - y0);
+
distance(1, 1, 2, 3); // 2.23606797749979
+

eloadvanced

Computes the new ratings between two or more opponents using the Elo rating system. It takes an array of pre-ratings and returns an array containing post-ratings. The array should be ordered from best performer to worst performer (winner -> loser).

Use the exponent ** operator and math operators to compute the expected score (chance of winning). of each opponent and compute the new rating for each. Loop through the ratings, using each permutation to compute the post-Elo rating for each player in a pairwise fashion. Omit the second argument to use the default kFactor of 32.

const elo = ([...ratings], kFactor = 32, selfRating) => {
+  const [a, b] = ratings;
+  const expectedScore = (self, opponent) => 1 / (1 + 10 ** ((opponent - self) / 400));
+  const newRating = (rating, i) =>
+    (selfRating || rating) + kFactor * (i - expectedScore(i ? a : b, i ? b : a));
+  if (ratings.length === 2) {
+    return [newRating(a, 1), newRating(b, 0)];
+  } else {
+    for (let i = 0; i < ratings.length; i++) {
+      let j = i;
+      while (j < ratings.length - 1) {
+        [ratings[i], ratings[j + 1]] = elo([ratings[i], ratings[j + 1]], kFactor);
+        j++;
+      }
+    }
+  }
+  return ratings;
+};
+
// Standard 1v1s
+elo([1200, 1200]); // [1216, 1184]
+elo([1200, 1200], 64); // [1232, 1168]
+// 4 player FFA, all same rank
+elo([1200, 1200, 1200, 1200]).map(Math.round); // [1246, 1215, 1185, 1154]
+/*
+For teams, each rating can adjusted based on own team's average rating vs.
+average rating of opposing team, with the score being added to their
+own individual rating by supplying it as the third argument.
+*/
+

factorial

Calculates the factorial of a number.

Use recursion. If n is less than or equal to 1, return 1. Otherwise, return the product of n and the factorial of n - 1. Throws an exception if n is a negative number.

const factorial = n =>
+  n < 0
+    ? (() => {
+        throw new TypeError('Negative numbers are not allowed!');
+      })()
+    : n <= 1 ? 1 : n * factorial(n - 1);
+
factorial(6); // 720
+

fibonacci

Generates an array, containing the Fibonacci sequence, up until the nth term.

Create an empty array of the specific length, initializing the first two values (0 and 1). Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.

const fibonacci = n =>
+  Array.from({ length: n }).reduce(
+    (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
+    []
+  );
+
fibonacci(6); // [0, 1, 1, 2, 3, 5]
+

gcd

Calculates the greatest common divisor between two or more numbers/arrays.

The inner _gcd function uses recursion. Base case is when y equals 0. In this case, return x. Otherwise, return the GCD of y and the remainder of the division x/y.

const gcd = (...arr) => {
+  const _gcd = (x, y) => (!y ? x : gcd(y, x % y));
+  return [...arr].reduce((a, b) => _gcd(a, b));
+};
+
gcd(8, 36); // 4
+gcd(...[12, 8, 32]); // 4
+

geometricProgression

Initializes an array containing the numbers in the specified range where start and end are inclusive and the ratio between two terms is step. Returns an error if step equals 1.

Use Array.from(), Math.log() and Math.floor() to create an array of the desired length, Array.map() to fill with the desired values in a range. Omit the second argument, start, to use a default value of 1. Omit the third argument, step, to use a default value of 2.

const geometricProgression = (end, start = 1, step = 2) =>
+  Array.from({ length: Math.floor(Math.log(end / start) / Math.log(step)) + 1 }).map(
+    (v, i) => start * step ** i
+  );
+
geometricProgression(256); // [1, 2, 4, 8, 16, 32, 64, 128, 256]
+geometricProgression(256, 3); // [3, 6, 12, 24, 48, 96, 192]
+geometricProgression(256, 1, 4); // [1, 4, 16, 64, 256]
+

hammingDistance

Calculates the Hamming distance between two values.

Use XOR operator (^) to find the bit difference between the two numbers, convert to a binary string using toString(2). Count and return the number of 1s in the string, using match(/1/g).

const hammingDistance = (num1, num2) => ((num1 ^ num2).toString(2).match(/1/g) || '').length;
+
hammingDistance(2, 3); // 1
+

inRange

Checks if the given number falls within the given range.

Use arithmetic comparison to check if the given number is in the specified range. If the second parameter, end, is not specified, the range is considered to be from 0 to start.

const inRange = (n, start, end = null) => {
+  if (end && start > end) end = [start, (start = end)][0];
+  return end == null ? n >= 0 && n < start : n >= start && n < end;
+};
+
inRange(3, 2, 5); // true
+inRange(3, 4); // true
+inRange(2, 3, 5); // false
+inrange(3, 2); // false
+

isDivisible

Checks if the first numeric argument is divisible by the second one.

Use the modulo operator (%) to check if the remainder is equal to 0.

const isDivisible = (dividend, divisor) => dividend % divisor === 0;
+
isDivisible(6, 3); // true
+

isEven

Returns true if the given number is even, false otherwise.

Checks whether a number is odd or even using the modulo (%) operator. Returns true if the number is even, false if the number is odd.

const isEven = num => num % 2 === 0;
+
isEven(3); // false
+

isPrime

Checks if the provided integer is a prime number.

Check numbers from 2 to the square root of the given number. Return false if any of them divides the given number, else return true, unless the number is less than 2.

const isPrime = num => {
+  const boundary = Math.floor(Math.sqrt(num));
+  for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
+  return num >= 2;
+};
+
isPrime(11); // true
+

lcm

Returns the least common multiple of two or more numbers.

Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. The GCD formula uses recursion.

const lcm = (...arr) => {
+  const gcd = (x, y) => (!y ? x : gcd(y, x % y));
+  const _lcm = (x, y) => x * y / gcd(x, y);
+  return [...arr].reduce((a, b) => _lcm(a, b));
+};
+
lcm(12, 7); // 84
+lcm(...[1, 3, 4, 5]); // 60
+

luhnCheck

Implementation of the Luhn Algorithm used to validate a variety of identification numbers, such as credit card numbers, IMEI numbers, National Provider Identifier numbers etc.

Use String.split(''), Array.reverse() and Array.map() in combination with parseInt() to obtain an array of digits. Use Array.splice(0,1) to obtain the last digit. Use Array.reduce() to implement the Luhn Algorithm. Return true if sum is divisible by 10, false otherwise.

const luhnCheck = num => {
+  let arr = (num + '')
+    .split('')
+    .reverse()
+    .map(x => parseInt(x));
+  let lastDigit = arr.splice(0, 1)[0];
+  let sum = arr.reduce((acc, val, i) => (i % 2 !== 0 ? acc + val : acc + (val * 2) % 9 || 9), 0);
+  sum += lastDigit;
+  return sum % 10 === 0;
+};
+
luhnCheck('4485275742308327'); // true
+luhnCheck(6011329933655299); //  false
+luhnCheck(123456789); // false
+

maxBy

Returns the maximum value of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Math.max() to get the maximum value.

const maxBy = (arr, fn) => Math.max(...arr.map(typeof fn === 'function' ? fn : val => val[fn]));
+
maxBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 8
+maxBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 8
+

median

Returns the median of an array of numbers.

Find the middle of the array, use Array.sort() to sort the values. Return the number at the midpoint if length is odd, otherwise the average of the two middle numbers.

const median = arr => {
+  const mid = Math.floor(arr.length / 2),
+    nums = [...arr].sort((a, b) => a - b);
+  return arr.length % 2 !== 0 ? nums[mid] : (nums[mid - 1] + nums[mid]) / 2;
+};
+
median([5, 6, 50, 1, -5]); // 5
+

minBy

Returns the minimum value of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Math.min() to get the maximum value.

const minBy = (arr, fn) => Math.min(...arr.map(typeof fn === 'function' ? fn : val => val[fn]));
+
minBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 2
+minBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 2
+

percentile

Uses the percentile formula to calculate how many numbers in the given array are less or equal to the given value.

Use Array.reduce() to calculate how many numbers are below the value and how many are the same value and apply the percentile formula.

const percentile = (arr, val) =>
+  100 * arr.reduce((acc, v) => acc + (v < val ? 1 : 0) + (v === val ? 0.5 : 0), 0) / arr.length;
+
percentile([1, 2, 3, 4, 5, 6, 7, 8, 9, 10], 6); // 55
+

powerset

Returns the powerset of a given array of numbers.

Use Array.reduce() combined with Array.map() to iterate over elements and combine into an array containing all combinations.

const powerset = arr => arr.reduce((a, v) => a.concat(a.map(r => [v].concat(r))), [[]]);
+
powerset([1, 2]); // [[], [1], [2], [2,1]]
+

primes

Generates primes up to a given number, using the Sieve of Eratosthenes.

Generate an array from 2 to the given number. Use Array.filter() to filter out the values divisible by any number from 2 to the square root of the provided number.

const primes = num => {
+  let arr = Array.from({ length: num - 1 }).map((x, i) => i + 2),
+    sqroot = Math.floor(Math.sqrt(num)),
+    numsTillSqroot = Array.from({ length: sqroot - 1 }).map((x, i) => i + 2);
+  numsTillSqroot.forEach(x => (arr = arr.filter(y => y % x !== 0 || y === x)));
+  return arr;
+};
+
primes(10); // [2,3,5,7]
+

radsToDegrees

Converts an angle from radians to degrees.

Use Math.PI and the radian to degree formula to convert the angle from radians to degrees.

const radsToDegrees = rad => rad * 180.0 / Math.PI;
+
radsToDegrees(Math.PI / 2); // 90
+

randomIntArrayInRange

Returns an array of n random integers in the specified range.

Use Array.from() to create an empty array of the specific length, Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

const randomIntArrayInRange = (min, max, n = 1) =>
+  Array.from({ length: n }, () => Math.floor(Math.random() * (max - min + 1)) + min);
+
randomIntArrayInRange(12, 35, 10); // [ 34, 14, 27, 17, 30, 27, 20, 26, 21, 14 ]
+

randomIntegerInRange

Returns a random integer in the specified range.

Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+
randomIntegerInRange(0, 5); // 2
+

randomNumberInRange

Returns a random number in the specified range.

Use Math.random() to generate a random value, map it to the desired range using multiplication.

const randomNumberInRange = (min, max) => Math.random() * (max - min) + min;
+
randomNumberInRange(2, 10); // 6.0211363285087005
+

round

Rounds a number to a specified amount of digits.

Use Math.round() and template literals to round the number to the specified number of digits. Omit the second argument, decimals to round to an integer.

const round = (n, decimals = 0) => Number(`${Math.round(`${n}e${decimals}`)}e-${decimals}`);
+
round(1.005, 2); // 1.01
+

sdbm

Hashes the input string into a whole number.

Use String.split('') and Array.reduce() to create a hash of the input string, utilizing bit shifting.

const sdbm = str => {
+  let arr = str.split('');
+  return arr.reduce(
+    (hashCode, currentVal) =>
+      (hashCode = currentVal.charCodeAt(0) + (hashCode << 6) + (hashCode << 16) - hashCode),
+    0
+  );
+};
+
sdbm('name'); // -3521204949
+

standardDeviation

Returns the standard deviation of an array of numbers.

Use Array.reduce() to calculate the mean, variance and the sum of the variance of the values, the variance of the values, then determine the standard deviation. You can omit the second argument to get the sample standard deviation or set it to true to get the population standard deviation.

const standardDeviation = (arr, usePopulation = false) => {
+  const mean = arr.reduce((acc, val) => acc + val, 0) / arr.length;
+  return Math.sqrt(
+    arr.reduce((acc, val) => acc.concat((val - mean) ** 2), []).reduce((acc, val) => acc + val, 0) /
+      (arr.length - (usePopulation ? 0 : 1))
+  );
+};
+
standardDeviation([10, 2, 38, 23, 38, 23, 21]); // 13.284434142114991 (sample)
+standardDeviation([10, 2, 38, 23, 38, 23, 21], true); // 12.29899614287479 (population)
+

sum

Returns the sum of two or more numbers/arrays.

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.

const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
+
sum(...[1, 2, 3, 4]); // 10
+

sumBy

Returns the sum of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Array.reduce() to add each value to an accumulator, initialized with a value of 0.

const sumBy = (arr, fn) =>
+  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val) => acc + val, 0);
+
sumBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 20
+sumBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 20
+

sumPower

Returns the sum of the powers of all the numbers from start to end (both inclusive).

Use Array.fill() to create an array of all the numbers in the target range, Array.map() and the exponent operator (**) to raise them to power and Array.reduce() to add them together. Omit the second argument, power, to use a default power of 2. Omit the third argument, start, to use a default starting value of 1.

const sumPower = (end, power = 2, start = 1) =>
+  Array(end + 1 - start)
+    .fill(0)
+    .map((x, i) => (i + start) ** power)
+    .reduce((a, b) => a + b, 0);
+
sumPower(10); // 385
+sumPower(10, 3); //3025
+sumPower(10, 3, 5); //2925
+

toSafeInteger

Converts a value to a safe integer.

Use Math.max() and Math.min() to find the closest safe value. Use Math.round() to convert to an integer.

const toSafeInteger = num =>
+  Math.round(Math.max(Math.min(num, Number.MAX_SAFE_INTEGER), Number.MIN_SAFE_INTEGER));
+
toSafeInteger('3.2'); // 3
+toSafeInteger(Infinity); // 9007199254740991
+
\ No newline at end of file diff --git a/docs/mini.css b/docs/mini.css index afb4775bf..042d073ec 100644 --- a/docs/mini.css +++ b/docs/mini.css @@ -1 +1 @@ -:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0} +:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2.index-section{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:1.25rem;color:#fff}@media screen and (max-width: 767px){#in-numbers{padding-bottom:1rem}}#in-numbers svg{fill:#fff}#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1.5rem}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}.pick.selected button.previous{position:absolute;top:50%;left:-1rem}.pick.selected button.previous>svg{margin-left:-0.0625rem}.pick.selected button.previous,.pick.selected button.next{border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s}.pick.selected button.previous>svg,.pick.selected button.next>svg{fill:#888;transition:all 0.3s}.pick.selected button.previous:hover,.pick.selected button.previous:focus,.pick.selected button.next:hover,.pick.selected button.next:focus{border-color:#aaa}.pick.selected button.previous:hover>svg,.pick.selected button.previous:focus>svg,.pick.selected button.next:hover>svg,.pick.selected button.next:focus>svg{fill:#444} diff --git a/docs/node.html b/docs/node.html new file mode 100644 index 000000000..95d446925 --- /dev/null +++ b/docs/node.html @@ -0,0 +1,157 @@ +Node - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Node

atob

Decodes a string of data which has been encoded using base-64 encoding.

Create a Buffer for the given string with base-64 encoding and use Buffer.toString('binary') to return the decoded string.

const atob = str => new Buffer(str, 'base64').toString('binary');
+
atob('Zm9vYmFy'); // 'foobar'
+

btoa

Creates a base-64 encoded ASCII string from a String object in which each character in the string is treated as a byte of binary data.

Create a Buffer for the given string with binary encoding and use Buffer.toString('base64') to return the encoded string.

const btoa = str => new Buffer(str, 'binary').toString('base64');
+
btoa('foobar'); // 'Zm9vYmFy'
+

colorize

Add special characters to text to print in color in the console (combined with console.log()).

Use template literals and special characters to add the appropriate color code to the string output. For background colors, add a special character that resets the background color at the end of the string.

const colorize = (...args) => ({
+  black: `\x1b[30m${args.join(' ')}`,
+  red: `\x1b[31m${args.join(' ')}`,
+  green: `\x1b[32m${args.join(' ')}`,
+  yellow: `\x1b[33m${args.join(' ')}`,
+  blue: `\x1b[34m${args.join(' ')}`,
+  magenta: `\x1b[35m${args.join(' ')}`,
+  cyan: `\x1b[36m${args.join(' ')}`,
+  white: `\x1b[37m${args.join(' ')}`,
+  bgBlack: `\x1b[40m${args.join(' ')}\x1b[0m`,
+  bgRed: `\x1b[41m${args.join(' ')}\x1b[0m`,
+  bgGreen: `\x1b[42m${args.join(' ')}\x1b[0m`,
+  bgYellow: `\x1b[43m${args.join(' ')}\x1b[0m`,
+  bgBlue: `\x1b[44m${args.join(' ')}\x1b[0m`,
+  bgMagenta: `\x1b[45m${args.join(' ')}\x1b[0m`,
+  bgCyan: `\x1b[46m${args.join(' ')}\x1b[0m`,
+  bgWhite: `\x1b[47m${args.join(' ')}\x1b[0m`
+});
+
console.log(colorize('foo').red); // 'foo' (red letters)
+console.log(colorize('foo', 'bar').bgBlue); // 'foo bar' (blue background)
+console.log(colorize(colorize('foo').yellow, colorize('foo').green).bgWhite); // 'foo bar' (first word in yellow letters, second word in green letters, white background for both)
+

hasFlags

Check if the current process's arguments contain the specified flags.

Use Array.every() and Array.includes() to check if process.argv contains all the specified flags. Use a regular expression to test if the specified flags are prefixed with - or -- and prefix them accordingly.

const hasFlags = (...flags) =>
+  flags.every(flag => process.argv.includes(/^-{1,2}/.test(flag) ? flag : '--' + flag));
+
// node myScript.js -s --test --cool=true
+hasFlags('-s'); // true
+hasFlags('--test', 'cool=true', '-s'); // true
+hasFlags('special'); // false
+

hashNode

Creates a hash for a value using the SHA-256 algorithm. Returns a promise.

Use crypto API to create a hash for the given value.

const crypto = require('crypto');
+const hashNode = val =>
+  new Promise(resolve =>
+    setTimeout(
+      () =>
+        resolve(
+          crypto
+            .createHash('sha256')
+            .update(val)
+            .digest('hex')
+        ),
+      0
+    )
+  );
+
hashNode(JSON.stringify({ a: 'a', b: [1, 2, 3, 4], foo: { c: 'bar' } })).then(console.log); // '04aa106279f5977f59f9067fa9712afc4aedc6f5862a8defc34552d8c7206393'
+

isTravisCI

Checks if the current environment is Travis CI.

Checks if the current environment has the TRAVIS and CI environment variables (reference).

const isTravisCI = () => 'TRAVIS' in process.env && 'CI' in process.env;
+
isTravisCI(); // true (if code is running on Travis CI)
+

JSONToFile

Writes a JSON object to a file.

Use fs.writeFile(), template literals and JSON.stringify() to write a json object to a .json file.

const fs = require('fs');
+const JSONToFile = (obj, filename) =>
+  fs.writeFile(`${filename}.json`, JSON.stringify(obj, null, 2));
+
JSONToFile({ test: 'is passed' }, 'testJsonFile'); // writes the object to 'testJsonFile.json'
+

readFileLines

Returns an array of lines from the specified file.

Use readFileSync function in fs node package to create a Buffer from a file. convert buffer to string using toString(encoding) function. creating an array from contents of file by spliting file content line by line (each \n).

const fs = require('fs');
+const readFileLines = filename =>
+  fs
+    .readFileSync(filename)
+    .toString('UTF8')
+    .split('\n');
+
/*
+contents of test.txt :
+  line1
+  line2
+  line3
+  ___________________________
+*/
+let arr = readFileLines('test.txt');
+console.log(arr); // ['line1', 'line2', 'line3']
+

untildify

Converts a tilde path to an absolute path.

Use String.replace() with a regular expression and OS.homedir() to replace the ~ in the start of the path with the home directory.

const untildify = str => str.replace(/^~($|\/|\\)/, `${require('os').homedir()}$1`);
+
untildify('~/node'); // '/Users/aUser/node'
+

UUIDGeneratorNode

Generates a UUID in Node.JS.

Use crypto API to generate a UUID, compliant with RFC4122 version 4.

const crypto = require('crypto');
+const UUIDGeneratorNode = () =>
+  ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c =>
+    (c ^ (crypto.randomBytes(1)[0] & (15 >> (c / 4)))).toString(16)
+  );
+
UUIDGeneratorNode(); // '79c7c136-60ee-40a2-beb2-856f1feabefc'
+
\ No newline at end of file diff --git a/docs/object.html b/docs/object.html new file mode 100644 index 000000000..e0c09d916 --- /dev/null +++ b/docs/object.html @@ -0,0 +1,335 @@ +Object - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Object

bindAll

Binds methods of an object to the object itself, overwriting the existing method.

Use Array.forEach() to return a function that uses Function.apply() to apply the given context (obj) to fn for each function specified.

const bindAll = (obj, ...fns) =>
+  fns.forEach(
+    fn => (
+      (f = obj[fn]),
+      (obj[fn] = function() {
+        return f.apply(obj);
+      })
+    )
+  );
+
var view = {
+  label: 'docs',
+  click: function() {
+    console.log('clicked ' + this.label);
+  }
+};
+bindAll(view, 'click');
+jQuery(element).on('click', view.click); // Logs 'clicked docs' when clicked.
+

deepClone

Creates a deep clone of an object.

Use recursion. Use Object.assign() and an empty object ({}) to create a shallow clone of the original. Use Object.keys() and Array.forEach() to determine which key-value pairs need to be deep cloned.

const deepClone = obj => {
+  let clone = Object.assign({}, obj);
+  Object.keys(clone).forEach(
+    key => (clone[key] = typeof obj[key] === 'object' ? deepClone(obj[key]) : obj[key])
+  );
+  return clone;
+};
+
const a = { foo: 'bar', obj: { a: 1, b: 2 } };
+const b = deepClone(a); // a !== b, a.obj !== b.obj
+

defaults

Assigns default values for all properties in an object that are undefined.

Use Object.assign() to create a new empty object and copy the original one to maintain key order, use Array.reverse() and the spread operator ... to combine the default values from left to right, finally use obj again to overwrite properties that originally had a value.

const defaults = (obj, ...defs) => Object.assign({}, obj, ...defs.reverse(), obj);
+
defaults({ a: 1 }, { b: 2 }, { b: 6 }, { a: 3 }); // { a: 1, b: 2 }
+

equalsadvanced

Performs a deep comparison between two values to determine if they are equivalent.

Check if the two values are identical, if they are both Date objects with the same time, using Date.getTime() or if they are both non-object values with an equivalent value (strict comparison). Check if only one value is null or undefined or if their prototypes differ. If none of the above conditions are met, use Object.keys() to check if both values have the same number of keys, then use Array.every() to check if every key in the first value exists in the second one and if they are equivalent by calling this method recursively.

const equals = (a, b) => {
+  if (a === b) return true;
+  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
+  if (!a || !b || (typeof a != 'object' && typeof b !== 'object')) return a === b;
+  if (a === null || a === undefined || b === null || b === undefined) return false;
+  if (a.prototype !== b.prototype) return false;
+  let keys = Object.keys(a);
+  if (keys.length !== Object.keys(b).length) return false;
+  return keys.every(k => equals(a[k], b[k]));
+};
+
equals({ a: [2, { e: 3 }], b: [4], c: 'foo' }, { a: [2, { e: 3 }], b: [4], c: 'foo' }); // true
+

findKey

Returns the first key that satisfies the provided testing function. Otherwise undefined is returned.

Use Object.keys(obj) to get all the properties of the object, Array.find() to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const findKey = (obj, fn) => Object.keys(obj).find(key => fn(obj[key], key, obj));
+
findKey(
+  {
+    barney: { age: 36, active: true },
+    fred: { age: 40, active: false },
+    pebbles: { age: 1, active: true }
+  },
+  o => o['active']
+); // 'barney'
+

findLastKey

Returns the last key that satisfies the provided testing function. Otherwise undefined is returned.

Use Object.keys(obj) to get all the properties of the object, Array.reverse() to reverse their order and Array.find() to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const findLastKey = (obj, fn) =>
+  Object.keys(obj)
+    .reverse()
+    .find(key => fn(obj[key], key, obj));
+
findLastKey(
+  {
+    barney: { age: 36, active: true },
+    fred: { age: 40, active: false },
+    pebbles: { age: 1, active: true }
+  },
+  o => o['active']
+); // 'pebbles'
+

flattenObject

Flatten an object with the paths for keys.

Use recursion. Use Object.keys(obj) combined with Array.reduce() to convert every leaf node to a flattened path node. If the value of a key is an object, the function calls itself with the appropriate prefix to create the path using Object.assign(). Otherwise, it adds the appropriate prefixed key-value pair to the accumulator object. You should always omit the second argument, prefix, unless you want every key to have a prefix.

const flattenObject = (obj, prefix = '') =>
+  Object.keys(obj).reduce((acc, k) => {
+    const pre = prefix.length ? prefix + '.' : '';
+    if (typeof obj[k] === 'object') Object.assign(acc, flattenObject(obj[k], pre + k));
+    else acc[pre + k] = obj[k];
+    return acc;
+  }, {});
+
flattenObject({ a: { b: { c: 1 } }, d: 1 }); // { 'a.b.c': 1, d: 1 }
+

forOwn

Iterates over all own properties of an object, running a callback for each one.

Use Object.keys(obj) to get all the properties of the object, Array.forEach() to run the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const forOwn = (obj, fn) => Object.keys(obj).forEach(key => fn(obj[key], key, obj));
+
forOwn({ foo: 'bar', a: 1 }, v => console.log(v)); // 'bar', 1
+

forOwnRight

Iterates over all own properties of an object in reverse, running a callback for each one.

Use Object.keys(obj) to get all the properties of the object, Array.reverse() to reverse their order and Array.forEach() to run the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const forOwnRight = (obj, fn) =>
+  Object.keys(obj)
+    .reverse()
+    .forEach(key => fn(obj[key], key, obj));
+
forOwnRight({ foo: 'bar', a: 1 }, v => console.log(v)); // 1, 'bar'
+

functions

Returns an array of function property names from own (and optionally inherited) enumerable properties of an object.

Use Object.keys(obj) to iterate over the object's own properties. If inherited is true, use Object.get.PrototypeOf(obj) to also get the object's inherited properties. Use Array.filter() to keep only those properties that are functions. Omit the second argument, inherited, to not include inherited properties by default.

const functions = (obj, inherited = false) =>
+  (inherited
+    ? [...Object.keys(obj), ...Object.keys(Object.getPrototypeOf(obj))]
+    : Object.keys(obj)
+  ).filter(key => typeof obj[key] === 'function');
+
function Foo() {
+  this.a = () => 1;
+  this.b = () => 2;
+}
+Foo.prototype.c = () => 3;
+functions(new Foo()); // ['a', 'b']
+functions(new Foo(), true); // ['a', 'b', 'c']
+

get

Retrieve a set of properties indicated by the given selectors from an object.

Use Array.map() for each selector, String.replace() to replace square brackets with dots, String.split('.') to split each selector, Array.filter() to remove empty values and Array.reduce() to get the value indicated by it.

const get = (from, ...selectors) =>
+  [...selectors].map(s =>
+    s
+      .replace(/\[([^\[\]]*)\]/g, '.$1.')
+      .split('.')
+      .filter(t => t !== '')
+      .reduce((prev, cur) => prev && prev[cur], from)
+  );
+
const obj = { selector: { to: { val: 'val to select' } }, target: [1, 2, { a: 'test' }] };
+get(obj, 'selector.to.val', 'target[0]', 'target[2].a'); // ['val to select', 1, 'test']
+

invertKeyValues

Inverts the key-value pairs of an object, without mutating it. The corresponding inverted value of each inverted key is an array of keys responsible for generating the inverted value. If a function is supplied, it is applied to each inverted key.

Use Object.keys() and Array.reduce() to invert the key-value pairs of an object and apply the function provided (if any). Omit the second argument, fn, to get the inverted keys without applying a function to them.

const invertKeyValues = (obj, fn) =>
+  Object.keys(obj).reduce((acc, key) => {
+    const val = fn ? fn(obj[key]) : obj[key];
+    acc[val] = acc[val] || [];
+    acc[val].push(key);
+    return acc;
+  }, {});
+
invertKeyValues({ a: 1, b: 2, c: 1 }); // { 1: [ 'a', 'c' ], 2: [ 'b' ] }
+invertKeyValues({ a: 1, b: 2, c: 1 }, value => 'group' + value); // { group1: [ 'a', 'c' ], group2: [ 'b' ] }
+

lowercaseKeys

Creates a new object from the specified object, where all the keys are in lowercase.

Use Object.keys() and Array.reduce() to create a new object from the specified object. Convert each key in the original object to lowercase, using String.toLowerCase().

const lowercaseKeys = obj =>
+  Object.keys(obj).reduce((acc, key) => {
+    acc[key.toLowerCase()] = obj[key];
+    return acc;
+  }, {});
+
const myObj = { Name: 'Adam', sUrnAME: 'Smith' };
+const myObjLower = lowercaseKeys(myObj); // {name: 'Adam', surname: 'Smith'};
+

mapKeys

Creates an object with keys generated by running the provided function for each key and the same values as the provided object.

Use Object.keys(obj) to iterate over the object's keys. Use Array.reduce() to create a new object with the same values and mapped keys using fn.

const mapKeys = (obj, fn) =>
+  Object.keys(obj).reduce((acc, k) => {
+    acc[fn(obj[k], k, obj)] = obj[k];
+    return acc;
+  }, {});
+
mapKeys({ a: 1, b: 2 }, (val, key) => key + val); // { a1: 1, b2: 2 }
+

mapValues

Creates an object with the same keys as the provided object and values generated by running the provided function for each value.

Use Object.keys(obj) to iterate over the object's keys. Use Array.reduce() to create a new object with the same keys and mapped values using fn.

const mapValues = (obj, fn) =>
+  Object.keys(obj).reduce((acc, k) => {
+    acc[k] = fn(obj[k], k, obj);
+    return acc;
+  }, {});
+
const users = {
+  fred: { user: 'fred', age: 40 },
+  pebbles: { user: 'pebbles', age: 1 }
+};
+mapValues(users, u => u.age); // { fred: 40, pebbles: 1 }
+

matches

Compares two objects to determine if the first one contains equivalent property values to the second one.

Use Object.keys(source) to get all the keys of the second object, then Array.every(), Object.hasOwnProperty() and strict comparison to determine if all keys exist in the first object and have the same values.

const matches = (obj, source) =>
+  Object.keys(source).every(key => obj.hasOwnProperty(key) && obj[key] === source[key]);
+
matches({ age: 25, hair: 'long', beard: true }, { hair: 'long', beard: true }); // true
+matches({ hair: 'long', beard: true }, { age: 25, hair: 'long', beard: true }); // false
+

matchesWith

Compares two objects to determine if the first one contains equivalent property values to the second one, based on a provided function.

Use Object.keys(source) to get all the keys of the second object, then Array.every(), Object.hasOwnProperty() and the provided function to determine if all keys exist in the first object and have equivalent values. If no function is provided, the values will be compared using the equality operator.

const matchesWith = (obj, source, fn) =>
+  Object.keys(source).every(
+    key =>
+      obj.hasOwnProperty(key) && fn
+        ? fn(obj[key], source[key], key, obj, source)
+        : obj[key] == source[key]
+  );
+
const isGreeting = val => /^h(?:i|ello)$/.test(val);
+matchesWith(
+  { greeting: 'hello' },
+  { greeting: 'hi' },
+  (oV, sV) => isGreeting(oV) && isGreeting(sV)
+); // true
+

merge

Creates a new object from the combination of two or more objects.

Use Array.reduce() combined with Object.keys(obj) to iterate over all objects and keys. Use hasOwnProperty() and Array.concat() to append values for keys existing in multiple objects.

const merge = (...objs) =>
+  [...objs].reduce(
+    (acc, obj) =>
+      Object.keys(obj).reduce((a, k) => {
+        acc[k] = acc.hasOwnProperty(k) ? [].concat(acc[k]).concat(obj[k]) : obj[k];
+        return acc;
+      }, {}),
+    {}
+  );
+
const object = {
+  a: [{ x: 2 }, { y: 4 }],
+  b: 1
+};
+const other = {
+  a: { z: 3 },
+  b: [2, 3],
+  c: 'foo'
+};
+merge(object, other); // { a: [ { x: 2 }, { y: 4 }, { z: 3 } ], b: [ 1, 2, 3 ], c: 'foo' }
+

nest

Given a flat array of objects linked to one another, it will nest them recursively. Useful for nesting comments, such as the ones on reddit.com.

Use recursion. Use Array.filter() to filter the items where the id matches the link, then Array.map() to map each one to a new object that has a children property which recursively nests the items based on which ones are children of the current item. Omit the second argument, id, to default to null which indicates the object is not linked to another one (i.e. it is a top level object). Omit the third argument, link, to use 'parent_id' as the default property which links the object to another one by its id.

const nest = (items, id = null, link = 'parent_id') =>
+  items
+    .filter(item => item[link] === id)
+    .map(item => ({ ...item, children: nest(items, item.id) }));
+
// One top level comment
+const comments = [
+  { id: 1, parent_id: null },
+  { id: 2, parent_id: 1 },
+  { id: 3, parent_id: 1 },
+  { id: 4, parent_id: 2 },
+  { id: 5, parent_id: 4 }
+];
+const nestedComments = nest(comments); // [{ id: 1, parent_id: null, children: [...] }]
+

objectFromPairs

Creates an object from the given key-value pairs.

Use Array.reduce() to create and combine key-value pairs.

const objectFromPairs = arr => arr.reduce((a, v) => ((a[v[0]] = v[1]), a), {});
+
objectFromPairs([['a', 1], ['b', 2]]); // {a: 1, b: 2}
+

objectToPairs

Creates an array of key-value pair arrays from an object.

Use Object.keys() and Array.map() to iterate over the object's keys and produce an array with key-value pairs.

const objectToPairs = obj => Object.keys(obj).map(k => [k, obj[k]]);
+
objectToPairs({ a: 1, b: 2 }); // [['a',1],['b',2]]
+

omit

Omits the key-value pairs corresponding to the given keys from an object.

Use Object.keys(obj), Array.filter() and Array.includes() to remove the provided keys. Use Array.reduce() to convert the filtered keys back to an object with the corresponding key-value pairs.

const omit = (obj, arr) =>
+  Object.keys(obj)
+    .filter(k => !arr.includes(k))
+    .reduce((acc, key) => ((acc[key] = obj[key]), acc), {});
+
omit({ a: 1, b: '2', c: 3 }, ['b']); // { 'a': 1, 'c': 3 }
+

omitBy

Creates an object composed of the properties the given function returns falsey for. The function is invoked with two arguments: (value, key).

Use Object.keys(obj) and Array.filter()to remove the keys for which fn returns a truthy value. Use Array.reduce() to convert the filtered keys back to an object with the corresponding key-value pairs.

const omitBy = (obj, fn) =>
+  Object.keys(obj)
+    .filter(k => !fn(obj[k], k))
+    .reduce((acc, key) => ((acc[key] = obj[key]), acc), {});
+
omitBy({ a: 1, b: '2', c: 3 }, x => typeof x === 'number'); // { b: '2' }
+

orderBy

Returns a sorted array of objects ordered by properties and orders.

Uses Array.sort(), Array.reduce() on the props array with a default value of 0, use array destructuring to swap the properties position depending on the order passed. If no orders array is passed it sort by 'asc' by default.

const orderBy = (arr, props, orders) =>
+  [...arr].sort((a, b) =>
+    props.reduce((acc, prop, i) => {
+      if (acc === 0) {
+        const [p1, p2] = orders && orders[i] === 'desc' ? [b[prop], a[prop]] : [a[prop], b[prop]];
+        acc = p1 > p2 ? 1 : p1 < p2 ? -1 : 0;
+      }
+      return acc;
+    }, 0)
+  );
+
const users = [{ name: 'fred', age: 48 }, { name: 'barney', age: 36 }, { name: 'fred', age: 40 }];
+orderBy(users, ['name', 'age'], ['asc', 'desc']); // [{name: 'barney', age: 36}, {name: 'fred', age: 48}, {name: 'fred', age: 40}]
+orderBy(users, ['name', 'age']); // [{name: 'barney', age: 36}, {name: 'fred', age: 40}, {name: 'fred', age: 48}]
+

pick

Picks the key-value pairs corresponding to the given keys from an object.

Use Array.reduce() to convert the filtered/picked keys back to an object with the corresponding key-value pairs if the key exists in the object.

const pick = (obj, arr) =>
+  arr.reduce((acc, curr) => (curr in obj && (acc[curr] = obj[curr]), acc), {});
+
pick({ a: 1, b: '2', c: 3 }, ['a', 'c']); // { 'a': 1, 'c': 3 }
+

pickBy

Creates an object composed of the properties the given function returns truthy for. The function is invoked with two arguments: (value, key).

Use Object.keys(obj) and Array.filter()to remove the keys for which fn returns a falsey value. Use Array.reduce() to convert the filtered keys back to an object with the corresponding key-value pairs.

const pickBy = (obj, fn) =>
+  Object.keys(obj)
+    .filter(k => fn(obj[k], k))
+    .reduce((acc, key) => ((acc[key] = obj[key]), acc), {});
+
pickBy({ a: 1, b: '2', c: 3 }, x => typeof x === 'number'); // { 'a': 1, 'c': 3 }
+

shallowClone

Creates a shallow clone of an object.

Use Object.assign() and an empty object ({}) to create a shallow clone of the original.

const shallowClone = obj => Object.assign({}, obj);
+
const a = { x: true, y: 1 };
+const b = shallowClone(a); // a !== b
+

size

Get size of arrays, objects or strings.

Get type of val (array, object or string). Use length property for arrays. Use length or size value if available or number of keys for objects. Use size of a Blob object created from val for strings.

Split strings into array of characters with split('') and return its length.

const size = val =>
+  Array.isArray(val)
+    ? val.length
+    : val && typeof val === 'object'
+      ? val.size || val.length || Object.keys(val).length
+      : typeof val === 'string' ? new Blob([val]).size : 0;
+
size([1, 2, 3, 4, 5]); // 5
+size('size'); // 4
+size({ one: 1, two: 2, three: 3 }); // 3
+

transform

Applies a function against an accumulator and each key in the object (from left to right).

Use Object.keys(obj) to iterate over each key in the object, Array.reduce() to call the apply the specified function against the given accumulator.

const transform = (obj, fn, acc) => Object.keys(obj).reduce((a, k) => fn(a, obj[k], k, obj), acc);
+
transform(
+  { a: 1, b: 2, c: 1 },
+  (r, v, k) => {
+    (r[v] || (r[v] = [])).push(k);
+    return r;
+  },
+  {}
+); // { '1': ['a', 'c'], '2': ['b'] }
+

truthCheckCollection

Checks if the predicate (second argument) is truthy on all elements of a collection (first argument).

Use Array.every() to check if each passed object has the specified property and if it returns a truthy value.

const truthCheckCollection = (collection, pre) => collection.every(obj => obj[pre]);
+
truthCheckCollection([{ user: 'Tinky-Winky', sex: 'male' }, { user: 'Dipsy', sex: 'male' }], 'sex'); // true
+

unflattenObjectadvanced

Unlatten an object with the paths for keys.

Use Object.keys(obj) combined with Array.reduce() to convert flattened path node to a leaf node. If the value of a key contains a dot delimiter (.), use Array.split('.'), string transformations and JSON.parse() to create an object, then Object.assign() to create the leaf node. Otherwise, add the appropriate key-value pair to the accumulator object.

const unflattenObject = obj =>
+  Object.keys(obj).reduce((acc, k) => {
+    if (k.indexOf('.') !== -1) {
+      const keys = k.split('.');
+      Object.assign(
+        acc,
+        JSON.parse(
+          '{' +
+            keys.map((v, i) => (i !== keys.length - 1 ? `"${v}":{` : `"${v}":`)).join('') +
+            obj[k] +
+            '}'.repeat(keys.length)
+        )
+      );
+    } else acc[k] = obj[k];
+    return acc;
+  }, {});
+
unflattenObject({ 'a.b.c': 1, d: 1 }); // { a: { b: { c: 1 } }, d: 1 }
+
\ No newline at end of file diff --git a/docs/string.html b/docs/string.html new file mode 100644 index 000000000..351b0c1a1 --- /dev/null +++ b/docs/string.html @@ -0,0 +1,264 @@ +String - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

String

byteSize

Returns the length of a string in bytes.

Convert a given string to a Blob Object and find its size.

const byteSize = str => new Blob([str]).size;
+
byteSize('😀'); // 4
+byteSize('Hello World'); // 11
+

capitalize

Capitalizes the first letter of a string.

Use array destructuring and String.toUpperCase() to capitalize first letter, ...rest to get array of characters after first letter and then Array.join('') to make it a string again. Omit the lowerRest parameter to keep the rest of the string intact, or set it to true to convert to lowercase.

const capitalize = ([first, ...rest], lowerRest = false) =>
+  first.toUpperCase() + (lowerRest ? rest.join('').toLowerCase() : rest.join(''));
+
capitalize('fooBar'); // 'FooBar'
+capitalize('fooBar', true); // 'Foobar'
+

capitalizeEveryWord

Capitalizes the first letter of every word in a string.

Use String.replace() to match the first character of each word and String.toUpperCase() to capitalize it.

const capitalizeEveryWord = str => str.replace(/\b[a-z]/g, char => char.toUpperCase());
+
capitalizeEveryWord('hello world!'); // 'Hello World!'
+

decapitalize

Decapitalizes the first letter of a string.

Use array destructuring and String.toLowerCase() to decapitalize first letter, ...rest to get array of characters after first letter and then Array.join('') to make it a string again. Omit the upperRest parameter to keep the rest of the string intact, or set it to true to convert to uppercase.

const decapitalize = ([first, ...rest], upperRest = false) =>
+  first.toLowerCase() + (upperRest ? rest.join('').toUpperCase() : rest.join(''));
+
decapitalize('FooBar'); // 'fooBar'
+decapitalize('FooBar', true); // 'fOOBAR'
+

escapeHTML

Escapes a string for use in HTML.

Use String.replace() with a regexp that matches the characters that need to be escaped, using a callback function to replace each character instance with its associated escaped character using a dictionary (object).

const escapeHTML = str =>
+  str.replace(
+    /[&<>'"]/g,
+    tag =>
+      ({
+        '&': '&amp;',
+        '<': '&lt;',
+        '>': '&gt;',
+        "'": '&#39;',
+        '"': '&quot;'
+      }[tag] || tag)
+  );
+
escapeHTML('<a href="#">Me & you</a>'); // '&lt;a href=&quot;#&quot;&gt;Me &amp; you&lt;/a&gt;'
+

escapeRegExp

Escapes a string to use in a regular expression.

Use String.replace() to escape special characters.

const escapeRegExp = str => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
escapeRegExp('(test)'); // \\(test\\)
+

fromCamelCase

Converts a string from camelcase.

Use String.replace() to remove underscores, hyphens, and spaces and convert words to camelcase. Omit the second argument to use a default separator of _.

const fromCamelCase = (str, separator = '_') =>
+  str
+    .replace(/([a-z\d])([A-Z])/g, '$1' + separator + '$2')
+    .replace(/([A-Z]+)([A-Z][a-z\d]+)/g, '$1' + separator + '$2')
+    .toLowerCase();
+
fromCamelCase('someDatabaseFieldName', ' '); // 'some database field name'
+fromCamelCase('someLabelThatNeedsToBeCamelized', '-'); // 'some-label-that-needs-to-be-camelized'
+fromCamelCase('someJavascriptProperty', '_'); // 'some_javascript_property'
+

isAbsoluteURL

Returns true if the given string is an absolute URL, false otherwise.

Use a regular expression to test if the string is an absolute URL.

const isAbsoluteURL = str => /^[a-z][a-z0-9+.-]*:/.test(str);
+
isAbsoluteURL('https://google.com'); // true
+isAbsoluteURL('ftp://www.myserver.net'); // true
+isAbsoluteURL('/foo/bar'); // false
+

isAnagram

Checks if a string is an anagram of another string (case-insensitive, ignores spaces, punctuation and special characters).

Use String.toLowerCase(), String.replace() with an appropriate regular expression to remove unnecessary characters, String.split(''), Array.sort() and Array.join('') on both strings to normalize them, then check if their normalized forms are equal.

const isAnagram = (str1, str2) => {
+  const normalize = str =>
+    str
+      .toLowerCase()
+      .replace(/[^a-z0-9]/gi, '')
+      .split('')
+      .sort()
+      .join('');
+  return normalize(str1) === normalize(str2);
+};
+
isAnagram('iceman', 'cinema'); // true
+

isLowerCase

Checks if a string is lower case.

Convert the given string to lower case, using String.toLowerCase() and compare it to the original.

const isLowerCase = str => str === str.toLowerCase();
+
isLowerCase('abc'); // true
+isLowerCase('a3@$'); // true
+isLowerCase('Ab4'); // false
+

isUpperCase

Checks if a string is upper case.

Convert the given string to upper case, using String.toUpperCase() and compare it to the original.

const isUpperCase = str => str === str.toUpperCase();
+
isUpperCase('ABC'); // true
+isLowerCase('A3@$'); // true
+isLowerCase('aB4'); // false
+

mask

Replaces all but the last num of characters with the specified mask character.

Use String.slice() to grab the portion of the characters that need to be masked and use String.replace() with a regexp to replace every character with the mask character. Concatenate the masked characters with the remaining unmasked portion of the string. Omit the second argument, num, to keep a default of 4 characters unmasked. If num is negative, the unmasked characters will be at the start of the string. Omit the third argument, mask, to use a default character of '*' for the mask.

const mask = (cc, num = 4, mask = '*') =>
+  ('' + cc).slice(0, -num).replace(/./g, mask) + ('' + cc).slice(-num);
+
mask(1234567890); // '******7890'
+mask(1234567890, 3); // '*******890'
+mask(1234567890, -4, '$'); // '$$$$567890'
+

pad

Pads a string on both sides with the specified character, if it's shorter than the specified length.

Use String.padStart() and String.padEnd() to pad both sides of the given string. Omit the third argument, char, to use the whitespace character as the default padding character.

const pad = (str, length, char = ' ') =>
+  str.padStart((str.length + length) / 2, char).padEnd(length, char);
+
pad('cat', 8); // '  cat   '
+pad(String(42), 6, '0'); // '004200'
+pad('foobar', 3); // 'foobar'
+

palindrome

Returns true if the given string is a palindrome, false otherwise.

Convert string String.toLowerCase() and use String.replace() to remove non-alphanumeric characters from it. Then, String.split('') into individual characters, Array.reverse(), String.join('') and compare to the original, unreversed string, after converting it String.tolowerCase().

const palindrome = str => {
+  const s = str.toLowerCase().replace(/[\W_]/g, '');
+  return (
+    s ===
+    s
+      .split('')
+      .reverse()
+      .join('')
+  );
+};
+
palindrome('taco cat'); // true
+

pluralize

Returns the singular or plural form of the word based on the input number. If the first argument is an object, it will use a closure by returning a function that can auto-pluralize words that don't simply end in s if the supplied dictionary contains the word.

If num is either -1 or 1, return the singular form of the word. If num is any other number, return the plural form. Omit the third argument to use the default of the singular word + s, or supply a custom pluralized word when necessary. If the first argument is an object, utilize a closure by returning a function which can use the supplied dictionary to resolve the correct plural form of the word.

const pluralize = (val, word, plural = word + 's') => {
+  const _pluralize = (num, word, plural = word + 's') =>
+    [1, -1].includes(Number(num)) ? word : plural;
+  if (typeof val === 'object') return (num, word) => _pluralize(num, word, val[word]);
+  return _pluralize(val, word, plural);
+};
+
pluralize(0, 'apple'); // 'apples'
+pluralize(1, 'apple'); // 'apple'
+pluralize(2, 'apple'); // 'apples'
+pluralize(2, 'person', 'people'); // 'people'
+
+const PLURALS = {
+  person: 'people',
+  radius: 'radii'
+};
+const autoPluralize = pluralize(PLURALS);
+autoPluralize(2, 'person'); // 'people'
+

removeNonASCII

Removes non-printable ASCII characters.

Use a regular expression to remove non-printable ASCII characters.

const removeNonASCII = str => str.replace(/[^\x20-\x7E]/g, '');
+
removeNonASCII('äÄçÇéÉêlorem-ipsumöÖÐþúÚ'); // 'lorem-ipsum'
+

reverseString

Reverses a string.

Use the spread operator (...) and Array.reverse() to reverse the order of the characters in the string. Combine characters to get a string using String.join('').

const reverseString = str => [...str].reverse().join('');
+
reverseString('foobar'); // 'raboof'
+

sortCharactersInString

Alphabetically sorts the characters in a string.

Use the spread operator (...), Array.sort() and String.localeCompare() to sort the characters in str, recombine using String.join('').

const sortCharactersInString = str => [...str].sort((a, b) => a.localeCompare(b)).join('');
+
sortCharactersInString('cabbage'); // 'aabbceg'
+

splitLines

Splits a multiline string into an array of lines.

Use String.split() and a regular expression to match line breaks and create an array.

const splitLines = str => str.split(/\r?\n/);
+
splitLines('This\nis a\nmultiline\nstring.\n'); // ['This', 'is a', 'multiline', 'string.' , '']
+

stringPermutations

⚠️ WARNING: This function's execution time increases exponentially with each character. Anything more than 8 to 10 characters will cause your browser to hang as it tries to solve all the different combinations.

Generates all permutations of a string (contains duplicates).

Use recursion. For each letter in the given string, create all the partial permutations for the rest of its letters. Use Array.map() to combine the letter with each partial permutation, then Array.reduce() to combine all permutations in one array. Base cases are for string length equal to 2 or 1.

const stringPermutations = str => {
+  if (str.length <= 2) return str.length === 2 ? [str, str[1] + str[0]] : [str];
+  return str
+    .split('')
+    .reduce(
+      (acc, letter, i) =>
+        acc.concat(stringPermutations(str.slice(0, i) + str.slice(i + 1)).map(val => letter + val)),
+      []
+    );
+};
+
stringPermutations('abc'); // ['abc','acb','bac','bca','cab','cba']
+

stripHTMLTags

Removes HTML/XML tags from string.

Use a regular expression to remove HTML/XML tags from a string.

const stripHTMLTags = str => str.replace(/<[^>]*>/g, '');
+
stripHTMLTags('<p><em>lorem</em> <strong>ipsum</strong></p>'); // 'lorem ipsum'
+

toCamelCase

Converts a string to camelcase.

Break the string into words and combine them capitalizing the first letter of each word, using a regexp.

const toCamelCase = str => {
+  let s =
+    str &&
+    str
+      .match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)
+      .map(x => x.slice(0, 1).toUpperCase() + x.slice(1).toLowerCase())
+      .join('');
+  return s.slice(0, 1).toLowerCase() + s.slice(1);
+};
+
toCamelCase('some_database_field_name'); // 'someDatabaseFieldName'
+toCamelCase('Some label that needs to be camelized'); // 'someLabelThatNeedsToBeCamelized'
+toCamelCase('some-javascript-property'); // 'someJavascriptProperty'
+toCamelCase('some-mixed_string with spaces_underscores-and-hyphens'); // 'someMixedStringWithSpacesUnderscoresAndHyphens'
+

toKebabCase

Converts a string to kebab case.

Break the string into words and combine them adding - as a separator, using a regexp.

const toKebabCase = str =>
+  str &&
+  str
+    .match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)
+    .map(x => x.toLowerCase())
+    .join('-');
+
toKebabCase('camelCase'); // 'camel-case'
+toKebabCase('some text'); // 'some-text'
+toKebabCase('some-mixed_string With spaces_underscores-and-hyphens'); // 'some-mixed-string-with-spaces-underscores-and-hyphens'
+toKebabCase('AllThe-small Things'); // "all-the-small-things"
+toKebabCase('IAmListeningToFMWhileLoadingDifferentURLOnMyBrowserAndAlsoEditingSomeXMLAndHTML'); // "i-am-listening-to-fm-while-loading-different-url-on-my-browser-and-also-editing-xml-and-html"
+

toSnakeCase

Converts a string to snake case.

Break the string into words and combine them adding _ as a separator, using a regexp.

const toSnakeCase = str =>
+  str &&
+  str
+    .match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)
+    .map(x => x.toLowerCase())
+    .join('_');
+
toSnakeCase('camelCase'); // 'camel_case'
+toSnakeCase('some text'); // 'some_text'
+toSnakeCase('some-mixed_string With spaces_underscores-and-hyphens'); // 'some_mixed_string_with_spaces_underscores_and_hyphens'
+toSnakeCase('AllThe-small Things'); // "all_the_smal_things"
+toSnakeCase('IAmListeningToFMWhileLoadingDifferentURLOnMyBrowserAndAlsoEditingSomeXMLAndHTML'); // "i_am_listening_to_fm_while_loading_different_url_on_my_browser_and_also_editing_some_xml_and_html"
+

truncateString

Truncates a string up to a specified length.

Determine if the string's length is greater than num. Return the string truncated to the desired length, with '...' appended to the end or the original string.

const truncateString = (str, num) =>
+  str.length > num ? str.slice(0, num > 3 ? num - 3 : num) + '...' : str;
+
truncateString('boomerang', 7); // 'boom...'
+

unescapeHTML

Unescapes escaped HTML characters.

Use String.replace() with a regex that matches the characters that need to be unescaped, using a callback function to replace each escaped character instance with its associated unescaped character using a dictionary (object).

const unescapeHTML = str =>
+  str.replace(
+    /&amp;|&lt;|&gt;|&#39;|&quot;/g,
+    tag =>
+      ({
+        '&amp;': '&',
+        '&lt;': '<',
+        '&gt;': '>',
+        '&#39;': "'",
+        '&quot;': '"'
+      }[tag] || tag)
+  );
+
unescapeHTML('&lt;a href=&quot;#&quot;&gt;Me &amp; you&lt;/a&gt;'); // '<a href="#">Me & you</a>'
+

URLJoin

Joins all given URL segments together, then normalizes the resulting URL.

Use String.join('/') to combine URL segments, then a series of String.replace() calls with various regexps to normalize the resulting URL (remove double slashes, add proper slashes for protocol, remove slashes before parameters, combine parameters with '&' and normalize first parameter delimiter).

const URLJoin = (...args) =>
+  args
+    .join('/')
+    .replace(/[\/]+/g, '/')
+    .replace(/^(.+):\//, '$1://')
+    .replace(/^file:/, 'file:/')
+    .replace(/\/(\?|&|#[^!])/g, '$1')
+    .replace(/\?/g, '&')
+    .replace('&', '?');
+
URLJoin('http://www.google.com', 'a', '/b/cd', '?foo=123', '?bar=foo'); // 'http://www.google.com/a/b/cd?foo=123&bar=foo'
+

words

Converts a given string into an array of words.

Use String.split() with a supplied pattern (defaults to non-alpha as a regexp) to convert to an array of strings. Use Array.filter() to remove any empty strings. Omit the second argument to use the default regexp.

const words = (str, pattern = /[^a-zA-Z-]+/) => str.split(pattern).filter(Boolean);
+
words('I love javaScript!!'); // ["I", "love", "javaScript"]
+words('python, javaScript & coffee'); // ["python", "javaScript", "coffee"]
+
\ No newline at end of file diff --git a/docs/type.html b/docs/type.html new file mode 100644 index 000000000..fb8701bf4 --- /dev/null +++ b/docs/type.html @@ -0,0 +1,184 @@ +Type - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Type

getType

Returns the native type of a value.

Returns lowercased constructor name of value, "undefined" or "null" if value is undefined or null.

const getType = v =>
+  v === undefined ? 'undefined' : v === null ? 'null' : v.constructor.name.toLowerCase();
+
getType(new Set([1, 2, 3])); // 'set'
+

is

Checks if the provided value is of the specified type (doesn't work with literals).

Use the instanceof operator to check if the provided value is of the specified type.

const is = (type, val) => val instanceof type;
+
is(Array, [1]); // true
+is(ArrayBuffer, new ArrayBuffer()); // true
+is(Map, new Map()); // true
+is(RegExp, /./g); // true
+is(Set, new Set()); // true
+is(WeakMap, new WeakMap()); // true
+is(WeakSet, new WeakSet()); // true
+is(String, ''); // false
+is(String, new String('')); // true
+is(Number, 1); // false
+is(Number, new Number(1)); // true
+is(Boolean, true); // false
+is(Boolean, new Boolean(true)); // true
+

isArrayLike

Checks if the provided argument is array-like (i.e. is iterable).

Use the spread operator (...) to check if the provided argument is iterable inside a try... catch block and the comma operator (,) to return the appropriate value.

const isArrayLike = val => {
+  try {
+    return [...val], true;
+  } catch (e) {
+    return false;
+  }
+};
+
isArrayLike(document.querySelectorAll('.className')); // true
+isArrayLike('abc'); // true
+isArrayLike(null); // false
+

isBoolean

Checks if the given argument is a native boolean element.

Use typeof to check if a value is classified as a boolean primitive.

const isBoolean = val => typeof val === 'boolean';
+
isBoolean(null); // false
+isBoolean(false); // true
+

isEmpty

Returns true if the a value is an empty object, collection, map or set, has no enumerable properties or is any type that is not considered a collection.

Check if the provided value is null or if its length is equal to 0.

const isEmpty = val => val == null || !(Object.keys(val) || val).length;
+
isEmpty(new Map()); // true
+isEmpty(new Set()); // true
+isEmpty([]); // true
+isEmpty({}); // true
+isEmpty(''); // true
+isEmpty([1, 2]); // false
+isEmpty({ a: 1, b: 2 }); // false
+isEmpty('text'); // false
+isEmpty(123); // true - type is not considered a collection
+isEmpty(true); // true - type is not considered a collection
+

isFunction

Checks if the given argument is a function.

Use typeof to check if a value is classified as a function primitive.

const isFunction = val => typeof val === 'function';
+
isFunction('x'); // false
+isFunction(x => x); // true
+

isNil

Returns true if the specified value is null or undefined, false otherwise.

Use the strict equality operator to check if the value and of val are equal to null or undefined.

const isNil = val => val === undefined || val === null;
+
isNil(null); // true
+isNil(undefined); // true
+

isNull

Returns true if the specified value is null, false otherwise.

Use the strict equality operator to check if the value and of val are equal to null.

const isNull = val => val === null;
+
isNull(null); // true
+

isNumber

Checks if the given argument is a number.

Use typeof to check if a value is classified as a number primitive.

const isNumber = val => typeof val === 'number';
+
isNumber('1'); // false
+isNumber(1); // true
+

isObject

Returns a boolean determining if the passed value is an object or not.

Uses the Object constructor to create an object wrapper for the given value. If the value is null or undefined, create and return an empty object. Οtherwise, return an object of a type that corresponds to the given value.

const isObject = obj => obj === Object(obj);
+
isObject([1, 2, 3, 4]); // true
+isObject([]); // true
+isObject(['Hello!']); // true
+isObject({ a: 1 }); // true
+isObject({}); // true
+isObject(true); // false
+

isObjectLike

Checks if a value is object-like.

Check if the provided value is not null and its typeof is equal to 'object'.

const isObjectLike = val => val !== null && typeof val === 'object';
+
isObjectLike({}); // true
+isObjectLike([1, 2, 3]); // true
+isObjectLike(x => x); // false
+isObjectLike(null); // false
+

isPlainObject

Checks if the provided value is an object created by the Object constructor.

Check if the provided value is truthy, use typeof to check if it is an object and Object.constructor to make sure the constructor is equal to Object.

const isPlainObject = val => !!val && typeof val === 'object' && val.constructor === Object;
+
isPlainObject({ a: 1 }); // true
+isPlainObject(new Map()); // false
+

isPrimitive

Returns a boolean determining if the passed value is primitive or not.

Use Array.includes() on an array of type strings which are not primitive, supplying the type using typeof. Since typeof null evaluates to 'object', it needs to be directly compared.

const isPrimitive = val => !['object', 'function'].includes(typeof val) || val === null;
+
isPrimitive(null); // true
+isPrimitive(50); // true
+isPrimitive('Hello!'); // true
+isPrimitive(false); // true
+isPrimitive(Symbol()); // true
+isPrimitive([]); // false
+

isPromiseLike

Returns true if an object looks like a Promise, false otherwise.

Check if the object is not null, its typeof matches either object or function and if it has a .then property, which is also a function.

const isPromiseLike = obj =>
+  obj !== null &&
+  (typeof obj === 'object' || typeof obj === 'function') &&
+  typeof obj.then === 'function';
+
isPromiseLike({
+  then: function() {
+    return '';
+  }
+}); // true
+isPromiseLike(null); // false
+isPromiseLike({}); // false
+

isString

Checks if the given argument is a string.

Use typeof to check if a value is classified as a string primitive.

const isString = val => typeof val === 'string';
+
isString('10'); // true
+

isSymbol

Checks if the given argument is a symbol.

Use typeof to check if a value is classified as a symbol primitive.

const isSymbol = val => typeof val === 'symbol';
+
isSymbol(Symbol('x')); // true
+

isUndefined

Returns true if the specified value is undefined, false otherwise.

Use the strict equality operator to check if the value and of val are equal to undefined.

const isUndefined = val => val === undefined;
+
isUndefined(undefined); // true
+

isValidJSON

Checks if the provided argument is a valid JSON.

Use JSON.parse() and a try... catch block to check if the provided argument is a valid JSON.

const isValidJSON = obj => {
+  try {
+    JSON.parse(obj);
+    return true;
+  } catch (e) {
+    return false;
+  }
+};
+
isValidJSON('{"name":"Adam","age":20}'); // true
+isValidJSON('{"name":"Adam",age:"20"}'); // false
+isValidJSON(null); // true
+
\ No newline at end of file diff --git a/docs/utility.html b/docs/utility.html new file mode 100644 index 000000000..a53d284ad --- /dev/null +++ b/docs/utility.html @@ -0,0 +1,275 @@ +Utility - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Utility

castArray

Casts the provided value as an array if it's not one.

Use Array.isArray() to determine if val is an array and return it as-is or encapsulated in an array accordingly.

const castArray = val => (Array.isArray(val) ? val : [val]);
+
castArray('foo'); // ['foo']
+castArray([1]); // [1]
+

cloneRegExp

Clones a regular expression.

Use new RegExp(), RegExp.source and RegExp.flags to clone the given regular expression.

const cloneRegExp = regExp => new RegExp(regExp.source, regExp.flags);
+
const regExp = /lorem ipsum/gi;
+const regExp2 = cloneRegExp(regExp); // /lorem ipsum/gi
+

coalesce

Returns the first non-null/undefined argument.

Use Array.find() to return the first non null/undefined argument.

const coalesce = (...args) => args.find(_ => ![undefined, null].includes(_));
+
coalesce(null, undefined, '', NaN, 'Waldo'); // ""
+

coalesceFactory

Returns a customized coalesce function that returns the first argument that returns true from the provided argument validation function.

Use Array.find() to return the first argument that returns true from the provided argument validation function.

const coalesceFactory = valid => (...args) => args.find(valid);
+
const customCoalesce = coalesceFactory(_ => ![null, undefined, '', NaN].includes(_));
+customCoalesce(undefined, null, NaN, '', 'Waldo'); // "Waldo"
+

extendHex

Extends a 3-digit color code to a 6-digit color code.

Use Array.map(), String.split() and Array.join() to join the mapped array for converting a 3-digit RGB notated hexadecimal color-code to the 6-digit form. Array.slice() is used to remove # from string start since it's added once.

const extendHex = shortHex =>
+  '#' +
+  shortHex
+    .slice(shortHex.startsWith('#') ? 1 : 0)
+    .split('')
+    .map(x => x + x)
+    .join('');
+
extendHex('#03f'); // '#0033ff'
+extendHex('05a'); // '#0055aa'
+

getURLParameters

Returns an object containing the parameters of the current URL.

Use String.match() with an appropriate regular expression to get all key-value pairs, Array.reduce() to map and combine them into a single object. Pass location.search as the argument to apply to the current url.

const getURLParameters = url =>
+  (url.match(/([^?=&]+)(=([^&]*))/g) || []).reduce(
+    (a, v) => ((a[v.slice(0, v.indexOf('='))] = v.slice(v.indexOf('=') + 1)), a),
+    {}
+  );
+
getURLParameters('http://url.com/page?name=Adam&surname=Smith'); // {name: 'Adam', surname: 'Smith'}
+getURLParameters('google.com'); // {}
+

hexToRGBadvanced

Converts a color code to a rgb() or rgba() string if alpha value is provided.

Use bitwise right-shift operator and mask bits with & (and) operator to convert a hexadecimal color code (with or without prefixed with #) to a string with the RGB values. If it's 3-digit color code, first convert to 6-digit version. If an alpha value is provided alongside 6-digit hex, give rgba() string in return.

const hexToRGB = hex => {
+  let alpha = false,
+    h = hex.slice(hex.startsWith('#') ? 1 : 0);
+  if (h.length === 3) h = [...h].map(x => x + x).join('');
+  else if (h.length === 8) alpha = true;
+  h = parseInt(h, 16);
+  return (
+    'rgb' +
+    (alpha ? 'a' : '') +
+    '(' +
+    (h >>> (alpha ? 24 : 16)) +
+    ', ' +
+    ((h & (alpha ? 0x00ff0000 : 0x00ff00)) >>> (alpha ? 16 : 8)) +
+    ', ' +
+    ((h & (alpha ? 0x0000ff00 : 0x0000ff)) >>> (alpha ? 8 : 0)) +
+    (alpha ? `, ${h & 0x000000ff}` : '') +
+    ')'
+  );
+};
+
hexToRGB('#27ae60ff'); // 'rgba(39, 174, 96, 255)'
+hexToRGB('27ae60'); // 'rgb(39, 174, 96)'
+hexToRGB('#fff'); // 'rgb(255, 255, 255)'
+

httpGet

Makes a GET request to the passed URL.

Use XMLHttpRequest web api to make a get request to the given url. Handle the onload event, by calling the given callback the responseText. Handle the onerror event, by running the provided err function. Omit the third argument, err, to log errors to the console's error stream by default.

const httpGet = (url, callback, err = console.error) => {
+  const request = new XMLHttpRequest();
+  request.open('GET', url, true);
+  request.onload = () => callback(request.responseText);
+  request.onerror = () => err(request);
+  request.send();
+};
+
httpGet(
+  'https://jsonplaceholder.typicode.com/posts/1',
+  console.log
+); /* 
+Logs: {
+  "userId": 1,
+  "id": 1,
+  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
+  "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
+}
+*/
+

httpPost

Makes a POST request to the passed URL.

Use XMLHttpRequest web api to make a post request to the given url. Set the value of an HTTP request header with setRequestHeader method. Handle the onload event, by calling the given callback the responseText. Handle the onerror event, by running the provided err function. Omit the third argument, data, to send no data to the provided url. Omit the fourth argument, err, to log errors to the console's error stream by default.

const httpPost = (url, data, callback, err = console.error) => {
+  const request = new XMLHttpRequest();
+  request.open('POST', url, true);
+  request.setRequestHeader('Content-type', 'application/json; charset=utf-8');
+  request.onload = () => callback(request.responseText);
+  request.onerror = () => err(request);
+  request.send(data);
+};
+
const newPost = {
+  userId: 1,
+  id: 1337,
+  title: 'Foo',
+  body: 'bar bar bar'
+};
+const data = JSON.stringify(newPost);
+httpPost(
+  'https://jsonplaceholder.typicode.com/posts',
+  data,
+  console.log
+); /*
+Logs: {
+  "userId": 1,
+  "id": 1337,
+  "title": "Foo",
+  "body": "bar bar bar"
+}
+*/
+httpPost(
+  'https://jsonplaceholder.typicode.com/posts',
+  null, //does not send a body
+  console.log
+); /*
+Logs: {
+  "id": 101
+}
+*/
+

isBrowser

Determines if the current runtime environment is a browser so that front-end modules can run on the server (Node) without throwing errors.

Use Array.includes() on the typeof values of both window and document (globals usually only available in a browser environment unless they were explicitly defined), which will return true if one of them is undefined. typeof allows globals to be checked for existence without throwing a ReferenceError. If both of them are not undefined, then the current environment is assumed to be a browser.

const isBrowser = () => ![typeof window, typeof document].includes('undefined');
+
isBrowser(); // true (browser)
+isBrowser(); // false (Node)
+

mostPerformant

Returns the index of the function in an array of functions which executed the fastest.

Use Array.map() to generate an array where each value is the total time taken to execute the function after iterations times. Use the difference in performance.now() values before and after to get the total time in milliseconds to a high degree of accuracy. Use Math.min() to find the minimum execution time, and return the index of that shortest time which corresponds to the index of the most performant function. Omit the second argument, iterations, to use a default of 10,000 iterations. The more iterations, the more reliable the result but the longer it will take.

const mostPerformant = (fns, iterations = 10000) => {
+  const times = fns.map(fn => {
+    const before = performance.now();
+    for (let i = 0; i < iterations; i++) fn();
+    return performance.now() - before;
+  });
+  return times.indexOf(Math.min(...times));
+};
+
mostPerformant([
+  () => {
+    // Loops through the entire array before returning `false`
+    [1, 2, 3, 4, 5, 6, 7, 8, 9, '10'].every(el => typeof el === 'number');
+  },
+  () => {
+    // Only needs to reach index `1` before returning false
+    [1, '2', 3, 4, 5, 6, 7, 8, 9, 10].every(el => typeof el === 'number');
+  }
+]); // 1
+

nthArg

Creates a function that gets the argument at index n. If n is negative, the nth argument from the end is returned.

Use Array.slice() to get the desired argument at index n.

const nthArg = n => (...args) => args.slice(n)[0];
+
const third = nthArg(2);
+third(1, 2, 3); // 3
+third(1, 2); // undefined
+const last = nthArg(-1);
+last(1, 2, 3, 4, 5); // 5
+

parseCookie

Parse an HTTP Cookie header string and return an object of all cookie name-value pairs.

Use String.split(';') to separate key-value pairs from each other. Use Array.map() and String.split('=') to separate keys from values in each pair. Use Array.reduce() and decodeURIComponent() to create an object with all key-value pairs.

const parseCookie = str =>
+  str
+    .split(';')
+    .map(v => v.split('='))
+    .reduce((acc, v) => {
+      acc[decodeURIComponent(v[0].trim())] = decodeURIComponent(v[1].trim());
+      return acc;
+    }, {});
+
parseCookie('foo=bar; equation=E%3Dmc%5E2'); // { foo: 'bar', equation: 'E=mc^2' }
+

prettyBytes

Converts a number in bytes to a human-readable string.

Use an array dictionary of units to be accessed based on the exponent. Use Number.toPrecision() to truncate the number to a certain number of digits. Return the prettified string by building it up, taking into account the supplied options and whether it is negative or not. Omit the second argument, precision, to use a default precision of 3 digits. Omit the third argument, addSpace, to add space between the number and unit by default.

const prettyBytes = (num, precision = 3, addSpace = true) => {
+  const UNITS = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+  if (Math.abs(num) < 1) return num + (addSpace ? ' ' : '') + UNITS[0];
+  const exponent = Math.min(Math.floor(Math.log10(num < 0 ? -num : num) / 3), UNITS.length - 1);
+  const n = Number(((num < 0 ? -num : num) / 1000 ** exponent).toPrecision(precision));
+  return (num < 0 ? '-' : '') + n + (addSpace ? ' ' : '') + UNITS[exponent];
+};
+
prettyBytes(1000); // "1 KB"
+prettyBytes(-27145424323.5821, 5); // "-27.145 GB"
+prettyBytes(123456789, 3, false); // "123MB"
+

randomHexColorCode

Generates a random hexadecimal color code.

Use Math.random to generate a random 24-bit(6x4bits) hexadecimal number. Use bit shifting and then convert it to an hexadecimal String using toString(16).

const randomHexColorCode = () => {
+  let n = (Math.random() * 0xfffff * 1000000).toString(16);
+  return '#' + n.slice(0, 6);
+};
+
randomHexColorCode(); // "#e34155"
+

RGBToHex

Converts the values of RGB components to a color code.

Convert given RGB parameters to hexadecimal string using bitwise left-shift operator (<<) and toString(16), then String.padStart(6,'0') to get a 6-digit hexadecimal value.

const RGBToHex = (r, g, b) => ((r << 16) + (g << 8) + b).toString(16).padStart(6, '0');
+
RGBToHex(255, 165, 1); // 'ffa501'
+

serializeCookie

Serialize a cookie name-value pair into a Set-Cookie header string.

Use template literals and encodeURIComponent() to create the appropriate string.

const serializeCookie = (name, val) => `${encodeURIComponent(name)}=${encodeURIComponent(val)}`;
+
serializeCookie('foo', 'bar'); // 'foo=bar'
+

timeTaken

Measures the time taken by a function to execute.

Use console.time() and console.timeEnd() to measure the difference between the start and end times to determine how long the callback took to execute.

const timeTaken = callback => {
+  console.time('timeTaken');
+  const r = callback();
+  console.timeEnd('timeTaken');
+  return r;
+};
+
timeTaken(() => Math.pow(2, 10)); // 1024, (logged): timeTaken: 0.02099609375ms
+

toCurrency

Take a number and return specified currency formatting.

Use Intl.NumberFormat to enable country / currency sensitive formatting.

const toCurrency = (n, curr, LanguageFormat = undefined) =>
+  Intl.NumberFormat(LanguageFormat, { style: 'currency', currency: curr }).format(n);
+
toCurrency(123456.789, 'EUR'); // €123,456.79  | currency: Euro | currencyLangFormat: Local
+toCurrency(123456.789, 'USD', 'en-us'); // $123,456.79  | currency: US Dollar | currencyLangFormat: English (United States)
+toCurrency(123456.789, 'USD', 'fa'); // ۱۲۳٬۴۵۶٫۷۹ ؜$ | currency: US Dollar | currencyLangFormat: Farsi
+toCurrency(322342436423.2435, 'JPY'); // ¥322,342,436,423 | currency: Japanese Yen | currencyLangFormat: Local
+toCurrency(322342436423.2435, 'JPY', 'fi'); // 322 342 436 423 ¥ | currency: Japanese Yen | currencyLangFormat: Finnish
+

toDecimalMark

Use toLocaleString() to convert a float-point arithmetic to the Decimal mark form. It makes a comma separated string from a number.

const toDecimalMark = num => num.toLocaleString('en-US');
+
toDecimalMark(12305030388.9087); // "12,305,030,388.909"
+

toOrdinalSuffix

Adds an ordinal suffix to a number.

Use the modulo operator (%) to find values of single and tens digits. Find which ordinal pattern digits match. If digit is found in teens pattern, use teens ordinal.

const toOrdinalSuffix = num => {
+  const int = parseInt(num),
+    digits = [int % 10, int % 100],
+    ordinals = ['st', 'nd', 'rd', 'th'],
+    oPattern = [1, 2, 3, 4],
+    tPattern = [11, 12, 13, 14, 15, 16, 17, 18, 19];
+  return oPattern.includes(digits[0]) && !tPattern.includes(digits[1])
+    ? int + ordinals[digits[0] - 1]
+    : int + ordinals[3];
+};
+
toOrdinalSuffix('123'); // "123rd"
+

validateNumber

Returns true if the given value is a number, false otherwise.

Use !isNaN() in combination with parseFloat() to check if the argument is a number. Use isFinite() to check if the number is finite. Use Number() to check if the coercion holds.

const validateNumber = n => !isNaN(parseFloat(n)) && isFinite(n) && Number(n) == n;
+
validateNumber('10'); // true
+

yesNo

Returns true if the string is y/yes or false if the string is n/no.

Use RegExp.test() to check if the string evaluates to y/yes or n/no. Omit the second argument, def to set the default answer as no.

const yesNo = (val, def = false) =>
+  /^(y|yes)$/i.test(val) ? true : /^(n|no)$/i.test(val) ? false : def;
+
yesNo('Y'); // true
+yesNo('yes'); // true
+yesNo('No'); // false
+yesNo('Foo', true); // true
+
\ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index 692553b30..0081d24ab 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -54,6 +54,7 @@ let snippets = {}, startPart = '', endPart = '', output = '', + pagesOutput = []; tagDbData = {}; // Start the timer of the script console.time('Webber'); @@ -61,8 +62,8 @@ console.time('Webber'); snippets = util.readSnippets(snippetsPath); // Load static parts for the index.html file try { - startPart = fs.readFileSync(path.join(staticPartsPath, 'index-start.html'), 'utf8'); - endPart = fs.readFileSync(path.join(staticPartsPath, 'index-end.html'), 'utf8'); + startPart = fs.readFileSync(path.join(staticPartsPath, 'page-start.html'), 'utf8'); + endPart = fs.readFileSync(path.join(staticPartsPath, 'page-end.html'), 'utf8'); } catch (err) { // Handle errors (hopefully not!) console.log(`${chalk.red('ERROR!')} During static part loading: ${err}`); @@ -78,8 +79,7 @@ try { for (let tag of [...new Set(Object.entries(tagDbData).map(t => t[1][0]))] .filter(v => v) .sort((a, b) => util.capitalize(a, true) === 'Uncategorized' ? 1 : util.capitalize(b, true) === 'Uncategorized' ? -1 : a.localeCompare(b))) { - output += - `

` + + output += `

` + md .render(`${util.capitalize(tag, true)}\n`) .replace(/

/g, '') @@ -87,7 +87,7 @@ try { `

`; for (let taggedSnippet of Object.entries(tagDbData).filter(v => v[1][0] === tag)) output += md - .render(`[${taggedSnippet[0]}](#${taggedSnippet[0].toLowerCase()})\n`) + .render(`[${taggedSnippet[0]}](./${tag}.html#${taggedSnippet[0].toLowerCase()})\n`) .replace(/

/g, '') .replace(/<\/p>/g, '') .replace(/ t[1][0]))] .filter(v => v) .sort((a, b) => util.capitalize(a, true) === 'Uncategorized' ? 1 : util.capitalize(b, true) === 'Uncategorized' ? -1 : a.localeCompare(b))) { - output += md + let localOutput = output.replace(/\$tag/g, util.capitalize(tag)).replace(new RegExp(`./${tag}.html#`,'g'),'#'); + localOutput += md .render(`## ${util.capitalize(tag, true)}\n`) .replace(/

/g, '

'); for (let taggedSnippet of Object.entries(tagDbData).filter(v => v[1][0] === tag)) - output += + localOutput += '
' + md .render(`\n${snippets[taggedSnippet[0] + '.md']}`) @@ -114,66 +115,43 @@ try { .replace(/<\/pre>\s+
📋 Copy to clipboard' +
           '
'; + // Add the ending static part + localOutput += `\n${endPart + '\n'}`; + localOutput = util.optimizeNodes(localOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize operator nodes + localOutput = util.optimizeNodes(localOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize keyword nodes + localOutput = util.optimizeNodes(localOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + pagesOutput.push({'tag': tag,'content': localOutput}); } - // Add the ending static part - output += `\n${endPart + '\n'}`; - // Optimize punctuation nodes - output = util.optimizeNodes(output, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); - // Optimize operator nodes - output = util.optimizeNodes(output, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); - // Optimize keyword nodes - output = util.optimizeNodes(output, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); - // do { - // const punctuationRegex = /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm; - // output = output.replace(punctuationRegex, - // (match, p1, p2, p3) => `${p1}${p2}${p3}` - // ); - // count = 0; - // while (punctuationRegex.exec(output) !== null) { - // ++count; - // } - // } while (count > 0); + // // Optimize punctuation nodes + // output = util.optimizeNodes(output, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); // // Optimize operator nodes - // do { - // const operatorRegex = /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm; - // output = output.replace(operatorRegex, - // (match, p1, p2, p3) => `${p1}${p2}${p3}` - // ); - // count = 0; - // while (operatorRegex.exec(output) !== null) { - // ++count; - // } - // } while (count > 0); + // output = util.optimizeNodes(output, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); // // Optimize keyword nodes - // do { - // const keyWordRegex = /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm; - // output = output.replace(keyWordRegex, - // (match, p1, p2, p3) => `${p1}${p2}${p3}` - // ); - // count = 0; - // while (keyWordRegex.exec(output) !== null) { - // ++count; - // } - // } while (count > 0); + // output = util.optimizeNodes(output, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); // Minify output - output = minify(output, { - collapseBooleanAttributes: true, - collapseWhitespace: true, - decodeEntities: false, - minifyCSS: true, - minifyJS: true, - keepClosingSlash: true, - processConditionalComments: true, - removeAttributeQuotes: false, - removeComments: true, - removeEmptyAttributes: false, - removeOptionalTags: false, - removeScriptTypeAttributes: false, - removeStyleLinkTypeAttributes: false, - trimCustomFragments: true - }); + pagesOutput.forEach(page => { + page.content = minify(page.content, { + collapseBooleanAttributes: true, + collapseWhitespace: true, + decodeEntities: false, + minifyCSS: true, + minifyJS: true, + keepClosingSlash: true, + processConditionalComments: true, + removeAttributeQuotes: false, + removeComments: true, + removeEmptyAttributes: false, + removeOptionalTags: false, + removeScriptTypeAttributes: false, + removeStyleLinkTypeAttributes: false, + trimCustomFragments: true + }); + fs.writeFileSync(path.join(docsPath, page.tag+'.html'), page.content); + }) // Write to the index.html file - fs.writeFileSync(path.join(docsPath, 'index.html'), output); + //fs.writeFileSync(path.join(docsPath, 'index.html'), output); } catch (err) { // Handle errors (hopefully not!) console.log(`${chalk.red('ERROR!')} During index.html generation: ${err}`); diff --git a/static-parts/index-end.html b/static-parts/page-end.html similarity index 100% rename from static-parts/index-end.html rename to static-parts/page-end.html diff --git a/static-parts/index-start.html b/static-parts/page-start.html similarity index 95% rename from static-parts/index-start.html rename to static-parts/page-start.html index d28a678f4..36adbaba3 100644 --- a/static-parts/index-start.html +++ b/static-parts/page-start.html @@ -2,7 +2,7 @@ - 30 seconds of code + $tag - 30 seconds of code @@ -53,6 +53,7 @@ window.setTimeout(function(){ document.getElementById('disclaimer').style.display = 'none'; }, 30000); + document.querySelector('nav').scrollTop = Array.from(document.querySelectorAll('h3')).filter(v => v.innerHTML === '$tag')[0].offsetTop - 60; } function registerClickListener() { document.addEventListener('click', function (event) { @@ -87,6 +88,7 @@ scrollToTop(); } else if (event.target.classList.contains('sublink-1')){ + if(event.target.getAttribute("href").includes('./')) return; event.preventDefault(); scrollTo(document.querySelector('main'), document.getElementById(event.target.href.split('#')[1]).parentElement.offsetTop - 60, event.target.href.split('#')[1], 400); document.getElementById('doc-drawer-checkbox').checked = false; @@ -96,12 +98,6 @@ -
-
-

⚠️ WARNING: Snippets are not production ready.

- -
-

logo 30 seconds of code From fcbb5c1a91af67af9ef991c68c0fe1c962d1d4c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 11:25:03 +0200 Subject: [PATCH 06/36] Add beginner static files --- scripts/web.js | 3 +++ static-parts/beginner-page-end.html | 3 +++ static-parts/beginner-page-start.html | 24 ++++++++++++++++++++++++ 3 files changed, 30 insertions(+) create mode 100644 static-parts/beginner-page-end.html create mode 100644 static-parts/beginner-page-start.html diff --git a/scripts/web.js b/scripts/web.js index 0081d24ab..58710f9ac 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -64,6 +64,9 @@ snippets = util.readSnippets(snippetsPath); try { startPart = fs.readFileSync(path.join(staticPartsPath, 'page-start.html'), 'utf8'); endPart = fs.readFileSync(path.join(staticPartsPath, 'page-end.html'), 'utf8'); + + beginnerStaticPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8'); + endStaticPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8'); } catch (err) { // Handle errors (hopefully not!) console.log(`${chalk.red('ERROR!')} During static part loading: ${err}`); diff --git a/static-parts/beginner-page-end.html b/static-parts/beginner-page-end.html new file mode 100644 index 000000000..886e2d2c7 --- /dev/null +++ b/static-parts/beginner-page-end.html @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html new file mode 100644 index 000000000..d367decd7 --- /dev/null +++ b/static-parts/beginner-page-start.html @@ -0,0 +1,24 @@ + + + + + 30 seconds of code - Beginner Section + + + + + + + + + + + +
+
+
+

Beginner snippets

+

The following section is aimed towards individuals who are at the start of their web developer journey.


+
+
+
\ No newline at end of file From 9a557401796593080a3ff7355b0c1a22c968fe17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 11:27:57 +0200 Subject: [PATCH 07/36] Update static files --- static-parts/beginner-page-start.html | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index d367decd7..c6bad26ea 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -14,11 +14,16 @@ -
-
-
-

Beginner snippets

-

The following section is aimed towards individuals who are at the start of their web developer journey.


-
+
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+
-
\ No newline at end of file +
+
+
+

Beginner snippets

+

The following section is aimed towards individuals who are at the start of their web developer journey.


+
+
+
\ No newline at end of file From 29b9f94d2ba0fbd0380d3aa52b5c3e8b8272f5ac Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 12:34:27 +0300 Subject: [PATCH 08/36] Add top contributors to landing page --- docs/mini/flavor.scss | 18 ++++++++++++++++++ static-parts/index.html | 40 +++++++++++++++++++++++++++++++++++++--- 2 files changed, 55 insertions(+), 3 deletions(-) diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss index 9a74715c7..ad5296d12 100644 --- a/docs/mini/flavor.scss +++ b/docs/mini/flavor.scss @@ -640,3 +640,21 @@ ul#links { } } } + +.card.contributor { + height: calc(100% - 1rem); + justify-content: left; + > .section.media { + height: auto; + } + > .section.button { + font-size: 0.75rem; + font-weight: 700; + text-align: center; + transition: color 0.3s; + &:hover, &:focus { + color: var(--a-l-col); + background: #f8f8f8; + } + } +} diff --git a/static-parts/index.html b/static-parts/index.html index 6f2010aa6..781f74a69 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -100,11 +100,45 @@
-
-

Top contributors

-

TODO using Github API


+
+

Top contributors

+
+
+ + Angelos Chalaris +
+
+
+ + Stefan Feješ +
+
+ + Felix Wu +
+
+ + atomiks +
+
+ + King David Martins +
+
+ + Rohit Tanwar +
+
+ + Soorena Soleimani +
+
+ + Robert Mennell +
+

How to contribute

From 9e583c2720106546bf434c068ec033f5b0f00cf0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 11:57:34 +0200 Subject: [PATCH 09/36] build beginner.html --- docs/beginner.html | 32 ++++++++++++++++++++++++++++++++ scripts/web.js | 24 ++++++++++++++++++++++-- 2 files changed, 54 insertions(+), 2 deletions(-) create mode 100644 docs/beginner.html diff --git a/docs/beginner.html b/docs/beginner.html new file mode 100644 index 000000000..55553fe5b --- /dev/null +++ b/docs/beginner.html @@ -0,0 +1,32 @@ + + + + + 30 seconds of code - Beginner Section + + + + + + + + + + + +
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+ +
+
+
+
+

Beginner snippets

+

The following section is aimed towards individuals who are at the start of their web developer journey.


+
+
+
+ + + \ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index 58710f9ac..53c8e4e61 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -51,9 +51,13 @@ const snippetsPath = './snippets', docsPath = './docs'; // Set variables for script let snippets = {}, + beginnerSnippets = ['everyNth', 'filterNonUnique', 'last', 'maxN', 'minN', 'nthElement', 'sample', 'similarity', 'tail', 'currentURL', 'hasClass', 'getMeridiemSuffixOfInteger', 'factorial', 'fibonacci', 'gcd', 'isDivisible', 'isEven', 'isPrime', 'lcm', 'randomIntegerInRange', 'sum', 'reverseString', 'truncateString'], startPart = '', endPart = '', output = '', + startBegginerPart = '', + endBegginerPart = '', + beginnerOutput = '', pagesOutput = []; tagDbData = {}; // Start the timer of the script @@ -65,8 +69,8 @@ try { startPart = fs.readFileSync(path.join(staticPartsPath, 'page-start.html'), 'utf8'); endPart = fs.readFileSync(path.join(staticPartsPath, 'page-end.html'), 'utf8'); - beginnerStaticPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8'); - endStaticPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8'); + startBeginnerPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8'); + endBeginnerPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8'); } catch (err) { // Handle errors (hopefully not!) console.log(`${chalk.red('ERROR!')} During static part loading: ${err}`); @@ -160,6 +164,22 @@ try { console.log(`${chalk.red('ERROR!')} During index.html generation: ${err}`); process.exit(1); } + +// Create the output for the beginner.html file + +try { + // Add the static part + beginnerOutput += `${startBeginnerPart + '\n'}`; + beginnerOutput += `${endBeginnerPart}`; + + fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput); + + +} catch (err) { + console.log(`${chalk.red('ERROR!')} During beginner.html generation: ${err}`); + process.exit(1); +} + // Log a success message console.log(`${chalk.green('SUCCESS!')} index.html file generated!`); // Log the time taken From 53f8f5676fcdb765e975fd1f5ca59be80b8442c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 12:04:42 +0200 Subject: [PATCH 10/36] update web.js --- docs/beginner.html | 2 +- scripts/web.js | 8 ++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/beginner.html b/docs/beginner.html index 55553fe5b..4a6ded7d2 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -27,6 +27,6 @@
- +
\ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index 53c8e4e61..b72a14be6 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -170,8 +170,16 @@ try { try { // Add the static part beginnerOutput += `${startBeginnerPart + '\n'}`; + + beginnerOutput += + '
' + + // begginer snippet goes here. + '' + + '
'; + beginnerOutput += `${endBeginnerPart}`; + // Generate fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput); From e73e09fa2f295d744b6eed513d5847f8543245b6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 12:51:41 +0200 Subject: [PATCH 11/36] Update web.js, generate beginner.html --- docs/beginner.html | 187 +++++++++++++++++++++++++- scripts/web.js | 30 ++++- static-parts/beginner-page-start.html | 2 +- 3 files changed, 213 insertions(+), 6 deletions(-) diff --git a/docs/beginner.html b/docs/beginner.html index 4a6ded7d2..3e6c16604 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -17,7 +17,7 @@

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

- +
@@ -27,6 +27,189 @@
-
+

currentURL

+

Returns the current URL.

+

Use window.location.href to get current URL.

+
const currentURL = () => window.location.href;
+
currentURL(); // 'https://google.com'
+
+

everyNth

+

Returns every nth element in an array.

+

Use Array.filter() to create a new array that contains every nth element of a given array.

+
const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
+
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
+
+

factorial

+

Calculates the factorial of a number.

+

Use recursion. +If n is less than or equal to 1, return 1. +Otherwise, return the product of n and the factorial of n - 1. +Throws an exception if n is a negative number.

+
const factorial = n =>
+  n < 0
+    ? (() => {
+        throw new TypeError('Negative numbers are not allowed!');
+      })()
+    : n <= 1 ? 1 : n * factorial(n - 1);
+
factorial(6); // 720
+
+

fibonacci

+

Generates an array, containing the Fibonacci sequence, up until the nth term.

+

Create an empty array of the specific length, initializing the first two values (0 and 1). +Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.

+
const fibonacci = n =>
+  Array.from({ length: n }).reduce(
+    (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
+    []
+  );
+
fibonacci(6); // [0, 1, 1, 2, 3, 5]
+
+

filterNonUnique

+

Filters out the non-unique values in an array.

+

Use Array.filter() for an array containing only the unique values.

+
const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
+
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]
+
+

gcd

+

Calculates the greatest common divisor between two or more numbers/arrays.

+

The inner _gcd function uses recursion. +Base case is when y equals 0. In this case, return x. +Otherwise, return the GCD of y and the remainder of the division x/y.

+
const gcd = (...arr) => {
+  const _gcd = (x, y) => (!y ? x : gcd(y, x % y));
+  return [...arr].reduce((a, b) => _gcd(a, b));
+};
+
gcd(8, 36); // 4
+gcd(...[12, 8, 32]); // 4
+
+

getMeridiemSuffixOfInteger

+

Converts an integer to a suffixed string, adding am or pm based on its value.

+

Use the modulo operator (%) and conditional checks to transform an integer to a stringified 12-hour format with meridiem suffix.

+
const getMeridiemSuffixOfInteger = num =>
+  num === 0 || num === 24
+    ? 12 + 'am'
+    : num === 12 ? 12 + 'pm' : num < 12 ? num % 12 + 'am' : num % 12 + 'pm';
+
getMeridiemSuffixOfInteger(0); // "12am"
+getMeridiemSuffixOfInteger(11); // "11am"
+getMeridiemSuffixOfInteger(13); // "1pm"
+getMeridiemSuffixOfInteger(25); // "1pm"
+
+

hasClass

+

Returns true if the element has the specified class, false otherwise.

+

Use element.classList.contains() to check if the element has the specified class.

+
const hasClass = (el, className) => el.classList.contains(className);
+
hasClass(document.querySelector('p.special'), 'special'); // true
+
+

isDivisible

+

Checks if the first numeric argument is divisible by the second one.

+

Use the modulo operator (%) to check if the remainder is equal to 0.

+
const isDivisible = (dividend, divisor) => dividend % divisor === 0;
+
isDivisible(6, 3); // true
+
+

isEven

+

Returns true if the given number is even, false otherwise.

+

Checks whether a number is odd or even using the modulo (%) operator. +Returns true if the number is even, false if the number is odd.

+
const isEven = num => num % 2 === 0;
+
isEven(3); // false
+
+

isPrime

+

Checks if the provided integer is a prime number.

+

Check numbers from 2 to the square root of the given number. +Return false if any of them divides the given number, else return true, unless the number is less than 2.

+
const isPrime = num => {
+  const boundary = Math.floor(Math.sqrt(num));
+  for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
+  return num >= 2;
+};
+
isPrime(11); // true
+
+

lcm

+

Returns the least common multiple of two or more numbers.

+

Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. +The GCD formula uses recursion.

+
const lcm = (...arr) => {
+  const gcd = (x, y) => (!y ? x : gcd(y, x % y));
+  const _lcm = (x, y) => x * y / gcd(x, y);
+  return [...arr].reduce((a, b) => _lcm(a, b));
+};
+
lcm(12, 7); // 84
+lcm(...[1, 3, 4, 5]); // 60
+
+

maxN

+

Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).

+

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order. +Use Array.slice() to get the specified number of elements. +Omit the second argument, n, to get a one-element array.

+
const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
+
maxN([1, 2, 3]); // [3]
+maxN([1, 2, 3], 2); // [3,2]
+
+

minN

+

Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).

+

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order. +Use Array.slice() to get the specified number of elements. +Omit the second argument, n, to get a one-element array.

+
const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
+
minN([1, 2, 3]); // [1]
+minN([1, 2, 3], 2); // [1,2]
+
+

nthElement

+

Returns the nth element of an array.

+

Use Array.slice() to get an array containing the nth element at the first place. +If the index is out of bounds, return []. +Omit the second argument, n, to get the first element of the array.

+
const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
+
nthElement(['a', 'b', 'c'], 1); // 'b'
+nthElement(['a', 'b', 'b'], -3); // 'a'
+
+

randomIntegerInRange

+

Returns a random integer in the specified range.

+

Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

+
const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+
randomIntegerInRange(0, 5); // 2
+
+

reverseString

+

Reverses a string.

+

Use the spread operator (...) and Array.reverse() to reverse the order of the characters in the string. +Combine characters to get a string using String.join('').

+
const reverseString = str => [...str].reverse().join('');
+
reverseString('foobar'); // 'raboof'
+
+

sample

+

Returns a random element from an array.

+

Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor(). +This method also works with strings.

+
const sample = arr => arr[Math.floor(Math.random() * arr.length)];
+
sample([3, 7, 9, 11]); // 9
+
+

similarity

+

Returns an array of elements that appear in both arrays.

+

Use Array.filter() to remove values that are not part of values, determined using Array.includes().

+
const similarity = (arr, values) => arr.filter(v => values.includes(v));
+
similarity([1, 2, 3], [1, 2, 4]); // [1,2]
+
+

sum

+

Returns the sum of two or more numbers/arrays.

+

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.

+
const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
+
sum(...[1, 2, 3, 4]); // 10
+
+

tail

+

Returns all elements in an array except for the first one.

+

Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.

+
const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
+
tail([1, 2, 3]); // [2,3]
+tail([1]); // [1]
+
+

truncateString

+

Truncates a string up to a specified length.

+

Determine if the string's length is greater than num. +Return the string truncated to the desired length, with '...' appended to the end or the original string.

+
const truncateString = (str, num) =>
+  str.length > num ? str.slice(0, num > 3 ? num - 3 : num) + '...' : str;
+
truncateString('boomerang', 7); // 'boom...'
+
+
\ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index b72a14be6..6f74c8578 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -51,11 +51,11 @@ const snippetsPath = './snippets', docsPath = './docs'; // Set variables for script let snippets = {}, - beginnerSnippets = ['everyNth', 'filterNonUnique', 'last', 'maxN', 'minN', 'nthElement', 'sample', 'similarity', 'tail', 'currentURL', 'hasClass', 'getMeridiemSuffixOfInteger', 'factorial', 'fibonacci', 'gcd', 'isDivisible', 'isEven', 'isPrime', 'lcm', 'randomIntegerInRange', 'sum', 'reverseString', 'truncateString'], + beginnerSnippetNames = ['everyNth', 'filterNonUnique', 'last.md', 'maxN', 'minN', 'nthElement', 'sample', 'similarity', 'tail', 'currentURL', 'hasClass', 'getMeridiemSuffixOfInteger', 'factorial', 'fibonacci', 'gcd', 'isDivisible', 'isEven', 'isPrime', 'lcm', 'randomIntegerInRange', 'sum', 'reverseString', 'truncateString'], startPart = '', endPart = '', output = '', - startBegginerPart = '', + startBeginnerPart = '', endBegginerPart = '', beginnerOutput = '', pagesOutput = []; @@ -64,6 +64,7 @@ let snippets = {}, console.time('Webber'); // Synchronously read all snippets and sort them as necessary (case-insensitive) snippets = util.readSnippets(snippetsPath); + // Load static parts for the index.html file try { startPart = fs.readFileSync(path.join(staticPartsPath, 'page-start.html'), 'utf8'); @@ -171,6 +172,29 @@ try { // Add the static part beginnerOutput += `${startBeginnerPart + '\n'}`; + // Filter begginer snippets + const filteredBeginnerSnippets = Object.keys(snippets) + .filter(key => beginnerSnippetNames.map(name => name+'.md').includes(key)) + .reduce((obj, key) => { + obj[key] = snippets[key]; + return obj; + }, {}); + + console.log(filteredBeginnerSnippets); + for (let snippet of Object.entries(filteredBeginnerSnippets)) + beginnerOutput += + '
' + + md + .render(`\n${snippets[snippet[0]]}`) + .replace(/

/g, `${snippet[1].includes('advanced')?'advanced':''}

`) + .replace(/<\/h3>/g, '

') + .replace(/
([^\0]*?)<\/code><\/pre>/gm, (match, p1) => `
${Prism.highlight(unescapeHTML(p1), Prism.languages.javascript)}
`)
+            .replace(/<\/pre>\s+
📋 Copy to clipboard' +
+          '
'; + + beginnerOutput += '
' + // begginer snippet goes here. @@ -179,7 +203,7 @@ try { beginnerOutput += `${endBeginnerPart}`; - // Generate + // Generate 'beginner.html' file fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput); diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index c6bad26ea..aefd3736f 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -17,7 +17,7 @@

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

- +
From fc5c64a5c18baa7aada5802eba41752757b8c2ef Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 13:53:40 +0300 Subject: [PATCH 12/36] Completed new landing page Updated counters position, added contribution guidelines, made some minor changes here and there. --- docs/mini/flavor.scss | 76 +++++++++- static-parts/index.html | 301 ++++++++++++++++++++++------------------ 2 files changed, 235 insertions(+), 142 deletions(-) diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss index ad5296d12..6014a8318 100644 --- a/docs/mini/flavor.scss +++ b/docs/mini/flavor.scss @@ -545,7 +545,7 @@ button#disclaimer-close{ } } -h2.index-section { +h2 { border-left: 0.3125rem solid #de4a6d; padding-left: 0.625rem; margin-top: 2rem; @@ -575,18 +575,38 @@ h2.index-section { #in-numbers { background: #111; //#3f88c5; //#e15554; - padding-top: 1.25rem; - @media screen and (max-width: 767px){ - padding-bottom: 1rem; - } + padding-top: 0.75rem; + padding-bottom: 0.75rem; color: #fff; svg { fill: #fff; + @media screen and (min-width: 768px){ + position: relative; + top: 20px; + left: -34px; + width: 32px; + height: 32px; + } + } + p { + overflow-wrap: break-word; + @media screen and (min-width: 768px){ + position: relative; + top: -24px; + left: 22px; + font-size: 0.75rem; + } + margin-top: 0; + font-size: 0.625rem; + margin-bottom: 0; } } #snippet-count, #contrib-count, #commit-count, #test-count { - font-size: 1.5rem; + font-size: 1rem; + @media screen and (min-width: 768px){ + font-size: 1.25rem; + } } ul#links { @@ -658,3 +678,47 @@ ul#links { } } } + +.card.fluid.contribution-guideline { + overflow: visible; + margin-top: 3rem; + padding-bottom: 0.25rem; + h3 { + padding-top: 0.5rem; + text-align: center; + } +} + +.contribution-guideline + .contribution-guideline { + &:before, &:after { + content: ''; + position: relative; + top: -2.75rem; + width: 0.375rem; + height: 0.375rem; + background: #ddd; + border: 0.03125rem solid #d0d0d0; + border-radius: 100%; + left: calc(50% - 0.1875rem); + box-shadow: inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05); + } + &:after { + position: absolute; + top: - 1.875rem; + } +} + +.contribution-number { + position: absolute; + top: -1.125rem; + left: calc(50% - 1.125rem); + font-size: 1.5rem; + background: linear-gradient(135deg, rgba(255,174,39,1) 0%,rgba(222,73,109,1) 100%); + border: 0.03125 solid #ddd; + width: 2.25rem; + text-align: center; + height: 2.25rem; + border-radius: 100%; + font-weight: 700; + color: #fff; +} diff --git a/static-parts/index.html b/static-parts/index.html index 781f74a69..c26ecdbe5 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -14,154 +14,185 @@ -
-

logo 30 seconds of code

-

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

- -
-
-
-
-

Our philosophy

-

The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


+
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+
-
-
-
-
-
-
+
+
+
+
+ +

295
snippets

+
+
+ +

114
contributors

+
+
+ +

3028
commits

+
+
+ +

999
tests

-

In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

-

-
-
-
-
-

Today's picks

-
- -

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
-  document.documentElement.clientHeight + window.scrollY >=
-  (document.documentElement.scrollHeight || document.documentElement.clientHeight);
-
bottomVisible(); // true
-
-

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
-
const firstTwoMax = ary(Math.max, 2);
-[[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
-
-
-
-
-
-
-
-
-
- -

295
snippets


-
-
- -

114
contributors


-
-
- -

3028
commits

-
-
- -

999
tests

-
-
-
-
-
-

Getting started

-
-
-
-
-
-

Related projects

-

The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

-
-
-
-
-
-

Top contributors

+
-
- - Angelos Chalaris -
+
+

Our philosophy

+

The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


-
- - Stefan Feješ -
-
- - Felix Wu -
-
- - atomiks -
-
- - King David Martins -
-
- - Rohit Tanwar -
-
- - Soorena Soleimani -
-
- - Robert Mennell -
+
+
+
+
+
+
+
+

In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

+
+

+
+
+
+
+

Today's picks

+
+ +

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
+      document.documentElement.clientHeight + window.scrollY >=
+      (document.documentElement.scrollHeight || document.documentElement.clientHeight);
+    
bottomVisible(); // true
+
+

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
+    
const firstTwoMax = ary(Math.max, 2);
+    [[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
+
+
+
+
-
-
-
-
-

How to contribute

-

TODO


+
+
+
+

Getting started

+
+
+
+
+
+

Related projects

+

The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

+
+
+
+
+
+

Top contributors

+
+
+ + Angelos Chalaris +
+
+
+ + Stefan Feješ +
+
+ + Felix Wu +
+
+ + atomiks +
+
+ + King David Martins +
+
+ + Rohit Tanwar +
+
+ + Soorena Soleimani +
+
+ + Robert Mennell +
+
+
+
+
+
+

How to contribute

+

Do you have a cool idea for a new snippet? Maybe some code you use often and is not part of our collection? Contributing to 30 seconds of code is as simple as 1,2,3,4!

+
+ 1 +
+

Create

+

Start by creating a snippet, according to the snippet template. Make sure to follow these simple guidelines:

+
    +
  • Your snippet title must be unique and the same as the name of the implemented function.
    • +
  • Use the snippet description to explain what your snippet does and how it works.
    • +
  • Try to keep the snippet's code short and to the point. Use modern techniques and features.
    • +
  • Remember to provide an example of how your snippet works.
    • +
  • Your snippet should solve a real-world problem, no matter how simple.
    • +
  • Never modify README.md or any of the HTML files.
    • +
+
+
+
+ 2 +
+

Tag

+

Run npm run tagger from your terminal, then open the tag_database file and tag your snippet appropriately. Multitagging is also supported, just make sure the first tag you specify is on of the major tags and the one that is most relevant to the implemneted function.

+
+
+
+ 3 +
+

Test

+

You can optionally test your snippet to make our job easier. Simply run npm run tester to generate the test files for your snippet. Find the related folder for you snippet under the test directory and write some tests. Remember to run npm run tester again to make sure your tests are passing.

+
+
+
+ 4 +
+

Pull request

+

If you have done everything mentioned above, you should now have an awesome snippet to add to our collection. Simply start a pull request and follow the guidelines provided. Remember to only submit one snippet per pull request, so that we can quickly evaluate and merge your code into the collection.

+
+
+

If you need additional pointers about writing a snippet, be sure to read the complete contribution guidelines.

+
+
-
-
- + From adc4b53ceee07617968763d4414f49f7564bc005 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 13:08:33 +0200 Subject: [PATCH 13/36] update static parts and final beginner.html --- docs/beginner.html | 50 ++++++++++++++------------- scripts/web.js | 4 ++- static-parts/beginner-page-end.html | 2 ++ static-parts/beginner-page-start.html | 1 - 4 files changed, 31 insertions(+), 26 deletions(-) diff --git a/docs/beginner.html b/docs/beginner.html index 3e6c16604..01274c709 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -26,20 +26,20 @@

The following section is aimed towards individuals who are at the start of their web developer journey.


-
-

currentURL

+ +

currentURL

Returns the current URL.

Use window.location.href to get current URL.

const currentURL = () => window.location.href;
 
currentURL(); // 'https://google.com'
-

everyNth

+

everyNth

Returns every nth element in an array.

Use Array.filter() to create a new array that contains every nth element of a given array.

const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
 
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
-

factorial

+

factorial

Calculates the factorial of a number.

Use recursion. If n is less than or equal to 1, return 1. @@ -53,7 +53,7 @@ Throws an exception if n is a negative number.

: n <= 1 ? 1 : n * factorial(n - 1); 
factorial(6); // 720
-

fibonacci

+

fibonacci

Generates an array, containing the Fibonacci sequence, up until the nth term.

Create an empty array of the specific length, initializing the first two values (0 and 1). Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.

@@ -64,13 +64,13 @@ Use Array.reduce() to add values into the array, using the sum of t ); 
fibonacci(6); // [0, 1, 1, 2, 3, 5]
-

filterNonUnique

+

filterNonUnique

Filters out the non-unique values in an array.

Use Array.filter() for an array containing only the unique values.

const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
 
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]
-

gcd

+

gcd

Calculates the greatest common divisor between two or more numbers/arrays.

The inner _gcd function uses recursion. Base case is when y equals 0. In this case, return x. @@ -82,7 +82,7 @@ Otherwise, return the GCD of y and the remainder of the division 

gcd(8, 36); // 4
 gcd(...[12, 8, 32]); // 4
-

getMeridiemSuffixOfInteger

+

getMeridiemSuffixOfInteger

Converts an integer to a suffixed string, adding am or pm based on its value.

Use the modulo operator (%) and conditional checks to transform an integer to a stringified 12-hour format with meridiem suffix.

const getMeridiemSuffixOfInteger = num =>
@@ -94,26 +94,26 @@ Otherwise, return the GCD of y and the remainder of the division getMeridiemSuffixOfInteger(13); // "1pm"
 getMeridiemSuffixOfInteger(25); // "1pm"
-

hasClass

+

hasClass

Returns true if the element has the specified class, false otherwise.

Use element.classList.contains() to check if the element has the specified class.

const hasClass = (el, className) => el.classList.contains(className);
 
hasClass(document.querySelector('p.special'), 'special'); // true
-

isDivisible

+

isDivisible

Checks if the first numeric argument is divisible by the second one.

Use the modulo operator (%) to check if the remainder is equal to 0.

const isDivisible = (dividend, divisor) => dividend % divisor === 0;
 
isDivisible(6, 3); // true
-

isEven

+

isEven

Returns true if the given number is even, false otherwise.

Checks whether a number is odd or even using the modulo (%) operator. Returns true if the number is even, false if the number is odd.

const isEven = num => num % 2 === 0;
 
isEven(3); // false
-

isPrime

+

isPrime

Checks if the provided integer is a prime number.

Check numbers from 2 to the square root of the given number. Return false if any of them divides the given number, else return true, unless the number is less than 2.

@@ -124,7 +124,7 @@ Return false if any of them divides the given number, else return < }; 
isPrime(11); // true
-

lcm

+

lcm

Returns the least common multiple of two or more numbers.

Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. The GCD formula uses recursion.

@@ -136,7 +136,7 @@ The GCD formula uses recursion.

lcm(12, 7); // 84
 lcm(...[1, 3, 4, 5]); // 60
-

maxN

+

maxN

Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order. Use Array.slice() to get the specified number of elements. @@ -145,7 +145,7 @@ Omit the second argument, n, to get a one-element array.

maxN([1, 2, 3]); // [3]
 maxN([1, 2, 3], 2); // [3,2]
-

minN

+

minN

Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order. Use Array.slice() to get the specified number of elements. @@ -154,7 +154,7 @@ Omit the second argument, n, to get a one-element array.

minN([1, 2, 3]); // [1]
 minN([1, 2, 3], 2); // [1,2]
-

nthElement

+

nthElement

Returns the nth element of an array.

Use Array.slice() to get an array containing the nth element at the first place. If the index is out of bounds, return []. @@ -163,46 +163,46 @@ Omit the second argument, n, to get the first element of the array. 

nthElement(['a', 'b', 'c'], 1); // 'b'
 nthElement(['a', 'b', 'b'], -3); // 'a'
-

randomIntegerInRange

+

randomIntegerInRange

Returns a random integer in the specified range.

Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
 
randomIntegerInRange(0, 5); // 2
-

reverseString

+

reverseString

Reverses a string.

Use the spread operator (...) and Array.reverse() to reverse the order of the characters in the string. Combine characters to get a string using String.join('').

const reverseString = str => [...str].reverse().join('');
 
reverseString('foobar'); // 'raboof'
-

sample

+

sample

Returns a random element from an array.

Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor(). This method also works with strings.

const sample = arr => arr[Math.floor(Math.random() * arr.length)];
 
sample([3, 7, 9, 11]); // 9
-

similarity

+

similarity

Returns an array of elements that appear in both arrays.

Use Array.filter() to remove values that are not part of values, determined using Array.includes().

const similarity = (arr, values) => arr.filter(v => values.includes(v));
 
similarity([1, 2, 3], [1, 2, 4]); // [1,2]
-

sum

+

sum

Returns the sum of two or more numbers/arrays.

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.

const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
 
sum(...[1, 2, 3, 4]); // 10
-

tail

+

tail

Returns all elements in an array except for the first one.

Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.

const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
 
tail([1, 2, 3]); // [2,3]
 tail([1]); // [1]
-

truncateString

+

truncateString

Truncates a string up to a specified length.

Determine if the string's length is greater than num. Return the string truncated to the desired length, with '...' appended to the end or the original string.

@@ -210,6 +210,8 @@ Return the string truncated to the desired length, with '...' appen str.length > num ? str.slice(0, num > 3 ? num - 3 : num) + '...' : str; 
truncateString('boomerang', 7); // 'boom...'
-
+
+
+ \ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index 6f74c8578..5822589a8 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -183,6 +183,8 @@ try { console.log(filteredBeginnerSnippets); for (let snippet of Object.entries(filteredBeginnerSnippets)) beginnerOutput += + '
' + + '
' + '
' + md .render(`\n${snippets[snippet[0]]}`) @@ -192,7 +194,7 @@ try { .replace(/
([^\0]*?)<\/code><\/pre>/gm, (match, p1) => `
${Prism.highlight(unescapeHTML(p1), Prism.languages.javascript)}
`)
             .replace(/<\/pre>\s+
📋 Copy to clipboard' +
-          '
'; + '
'; beginnerOutput += diff --git a/static-parts/beginner-page-end.html b/static-parts/beginner-page-end.html index 886e2d2c7..8c5b3ff89 100644 --- a/static-parts/beginner-page-end.html +++ b/static-parts/beginner-page-end.html @@ -1,3 +1,5 @@ + + \ No newline at end of file diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index aefd3736f..7a49e98e8 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -26,4 +26,3 @@

The following section is aimed towards individuals who are at the start of their web developer journey.


- \ No newline at end of file From b8d0d87136c36e535c5fa8e4ce5c258b249e417f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 13:27:56 +0200 Subject: [PATCH 14/36] update beginner page --- docs/beginner.html | 43 ++++++++++++++++++++++++++- scripts/web.js | 19 ++++-------- static-parts/beginner-page-start.html | 41 +++++++++++++++++++++++++ 3 files changed, 89 insertions(+), 14 deletions(-) diff --git a/docs/beginner.html b/docs/beginner.html index 01274c709..16c06e47d 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -12,6 +12,47 @@ +
@@ -210,7 +251,7 @@ Return the string truncated to the desired length, with '...' appen str.length > num ? str.slice(0, num > 3 ? num - 3 : num) + '...' : str; 
truncateString('boomerang', 7); // 'boom...'
-
+ diff --git a/scripts/web.js b/scripts/web.js index 5822589a8..a2d654366 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -55,8 +55,8 @@ let snippets = {}, startPart = '', endPart = '', output = '', - startBeginnerPart = '', - endBegginerPart = '', + beginnerStartPart = '', + beginnerEndPart = '', beginnerOutput = '', pagesOutput = []; tagDbData = {}; @@ -70,8 +70,8 @@ try { startPart = fs.readFileSync(path.join(staticPartsPath, 'page-start.html'), 'utf8'); endPart = fs.readFileSync(path.join(staticPartsPath, 'page-end.html'), 'utf8'); - startBeginnerPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8'); - endBeginnerPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8'); + beginnerStartPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8'); + beginnerEndPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8'); } catch (err) { // Handle errors (hopefully not!) console.log(`${chalk.red('ERROR!')} During static part loading: ${err}`); @@ -170,7 +170,7 @@ try { try { // Add the static part - beginnerOutput += `${startBeginnerPart + '\n'}`; + beginnerOutput += `${beginnerStartPart + '\n'}`; // Filter begginer snippets const filteredBeginnerSnippets = Object.keys(snippets) @@ -180,7 +180,6 @@ try { return obj; }, {}); - console.log(filteredBeginnerSnippets); for (let snippet of Object.entries(filteredBeginnerSnippets)) beginnerOutput += '
' + @@ -197,13 +196,7 @@ try { '
'; - beginnerOutput += - '
' + - // begginer snippet goes here. - '' + - '
'; - - beginnerOutput += `${endBeginnerPart}`; + beginnerOutput += `${beginnerEndPart}`; // Generate 'beginner.html' file fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput); diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index 7a49e98e8..edd03d57e 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -12,6 +12,47 @@ +
From 11e182457cc6f2b2444c8d2569267842162fe1b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 14:27:39 +0200 Subject: [PATCH 15/36] =?UTF-8?q?=F0=9F=90=9B=20=20toggle=20example?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/beginner.html | 168 +++++++++++--------------- scripts/web.js | 6 + static-parts/beginner-page-end.html | 1 + static-parts/beginner-page-start.html | 43 +------ 4 files changed, 82 insertions(+), 136 deletions(-) diff --git a/docs/beginner.html b/docs/beginner.html index 16c06e47d..5aa9a67aa 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -13,48 +13,17 @@ + }, false); + } + - + +

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

@@ -71,14 +40,14 @@

currentURL

Returns the current URL.

Use window.location.href to get current URL.

-
const currentURL = () => window.location.href;
-
currentURL(); // 'https://google.com'
+
const currentURL = () => window.location.href;
+
currentURL(); // 'https://google.com'

everyNth

Returns every nth element in an array.

Use Array.filter() to create a new array that contains every nth element of a given array.

-
const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
-
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
+
const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
+
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]

factorial

Calculates the factorial of a number.

@@ -88,28 +57,28 @@ Otherwise, return the product of n and the factorial of n - 1 Throws an exception if n is a negative number.

const factorial = n =>
   n < 0
-    ? (() => {
-        throw new TypeError('Negative numbers are not allowed!');
-      })()
-    : n <= 1 ? 1 : n * factorial(n - 1);
-
factorial(6); // 720
+    ? (() => {
+        throw new TypeError('Negative numbers are not allowed!');
+      })()
+    : n <= 1 ? 1 : n * factorial(n - 1);
+
factorial(6); // 720

fibonacci

Generates an array, containing the Fibonacci sequence, up until the nth term.

Create an empty array of the specific length, initializing the first two values (0 and 1). Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.

const fibonacci = n =>
-  Array.from({ length: n }).reduce(
-    (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
-    []
-  );
-
fibonacci(6); // [0, 1, 1, 2, 3, 5]
+  Array.from({ length: n }).reduce(
+    (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
+    []
+  );
+
fibonacci(6); // [0, 1, 1, 2, 3, 5]

filterNonUnique

Filters out the non-unique values in an array.

Use Array.filter() for an array containing only the unique values.

-
const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
-
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]
+
const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
+
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]

gcd

Calculates the greatest common divisor between two or more numbers/arrays.

@@ -117,11 +86,11 @@ Use Array.reduce() to add values into the array, using the sum of t Base case is when y equals 0. In this case, return x. Otherwise, return the GCD of y and the remainder of the division x/y.

const gcd = (...arr) => {
-  const _gcd = (x, y) => (!y ? x : gcd(y, x % y));
-  return [...arr].reduce((a, b) => _gcd(a, b));
-};
-
gcd(8, 36); // 4
-gcd(...[12, 8, 32]); // 4
+  const _gcd = (x, y) => (!y ? x : gcd(y, x % y));
+  return [...arr].reduce((a, b) => _gcd(a, b));
+};
+
gcd(8, 36); // 4
+gcd(...[12, 8, 32]); // 4

getMeridiemSuffixOfInteger

Converts an integer to a suffixed string, adding am or pm based on its value.

@@ -130,118 +99,118 @@ Otherwise, return the GCD of y and the remainder of the division === 0 || num === 24 ? 12 + 'am' : num === 12 ? 12 + 'pm' : num < 12 ? num % 12 + 'am' : num % 12 + 'pm'; -
getMeridiemSuffixOfInteger(0); // "12am"
-getMeridiemSuffixOfInteger(11); // "11am"
-getMeridiemSuffixOfInteger(13); // "1pm"
-getMeridiemSuffixOfInteger(25); // "1pm"
+
getMeridiemSuffixOfInteger(0); // "12am"
+getMeridiemSuffixOfInteger(11); // "11am"
+getMeridiemSuffixOfInteger(13); // "1pm"
+getMeridiemSuffixOfInteger(25); // "1pm"

hasClass

Returns true if the element has the specified class, false otherwise.

Use element.classList.contains() to check if the element has the specified class.

-
const hasClass = (el, className) => el.classList.contains(className);
-
hasClass(document.querySelector('p.special'), 'special'); // true
+
const hasClass = (el, className) => el.classList.contains(className);
+
hasClass(document.querySelector('p.special'), 'special'); // true

isDivisible

Checks if the first numeric argument is divisible by the second one.

Use the modulo operator (%) to check if the remainder is equal to 0.

const isDivisible = (dividend, divisor) => dividend % divisor === 0;
-
isDivisible(6, 3); // true
+
isDivisible(6, 3); // true

isEven

Returns true if the given number is even, false otherwise.

Checks whether a number is odd or even using the modulo (%) operator. Returns true if the number is even, false if the number is odd.

const isEven = num => num % 2 === 0;
-
isEven(3); // false
+
isEven(3); // false

isPrime

Checks if the provided integer is a prime number.

Check numbers from 2 to the square root of the given number. Return false if any of them divides the given number, else return true, unless the number is less than 2.

const isPrime = num => {
-  const boundary = Math.floor(Math.sqrt(num));
+  const boundary = Math.floor(Math.sqrt(num));
   for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
-  return num >= 2;
-};
-
isPrime(11); // true
+  return num >= 2;
+};
+
isPrime(11); // true

lcm

Returns the least common multiple of two or more numbers.

Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. The GCD formula uses recursion.

const lcm = (...arr) => {
-  const gcd = (x, y) => (!y ? x : gcd(y, x % y));
-  const _lcm = (x, y) => x * y / gcd(x, y);
-  return [...arr].reduce((a, b) => _lcm(a, b));
-};
-
lcm(12, 7); // 84
-lcm(...[1, 3, 4, 5]); // 60
+  const gcd = (x, y) => (!y ? x : gcd(y, x % y));
+  const _lcm = (x, y) => x * y / gcd(x, y);
+  return [...arr].reduce((a, b) => _lcm(a, b));
+};
+
lcm(12, 7); // 84
+lcm(...[1, 3, 4, 5]); // 60

maxN

Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.

-
const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
-
maxN([1, 2, 3]); // [3]
-maxN([1, 2, 3], 2); // [3,2]
+
const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
+
maxN([1, 2, 3]); // [3]
+maxN([1, 2, 3], 2); // [3,2]

minN

Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.

-
const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
-
minN([1, 2, 3]); // [1]
-minN([1, 2, 3], 2); // [1,2]
+
const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
+
minN([1, 2, 3]); // [1]
+minN([1, 2, 3], 2); // [1,2]

nthElement

Returns the nth element of an array.

Use Array.slice() to get an array containing the nth element at the first place. If the index is out of bounds, return []. Omit the second argument, n, to get the first element of the array.

-
const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
-
nthElement(['a', 'b', 'c'], 1); // 'b'
-nthElement(['a', 'b', 'b'], -3); // 'a'
+
const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
+
nthElement(['a', 'b', 'c'], 1); // 'b'
+nthElement(['a', 'b', 'b'], -3); // 'a'

randomIntegerInRange

Returns a random integer in the specified range.

Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

-
const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
-
randomIntegerInRange(0, 5); // 2
+
const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+
randomIntegerInRange(0, 5); // 2

reverseString

Reverses a string.

Use the spread operator (...) and Array.reverse() to reverse the order of the characters in the string. Combine characters to get a string using String.join('').

-
const reverseString = str => [...str].reverse().join('');
-
reverseString('foobar'); // 'raboof'
+
const reverseString = str => [...str].reverse().join('');
+
reverseString('foobar'); // 'raboof'

sample

Returns a random element from an array.

Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor(). This method also works with strings.

-
const sample = arr => arr[Math.floor(Math.random() * arr.length)];
-
sample([3, 7, 9, 11]); // 9
+
const sample = arr => arr[Math.floor(Math.random() * arr.length)];
+
sample([3, 7, 9, 11]); // 9

similarity

Returns an array of elements that appear in both arrays.

Use Array.filter() to remove values that are not part of values, determined using Array.includes().

-
const similarity = (arr, values) => arr.filter(v => values.includes(v));
-
similarity([1, 2, 3], [1, 2, 4]); // [1,2]
+
const similarity = (arr, values) => arr.filter(v => values.includes(v));
+
similarity([1, 2, 3], [1, 2, 4]); // [1,2]

sum

Returns the sum of two or more numbers/arrays.

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.

-
const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
-
sum(...[1, 2, 3, 4]); // 10
+
const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
+
sum(...[1, 2, 3, 4]); // 10

tail

Returns all elements in an array except for the first one.

Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.

-
const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
-
tail([1, 2, 3]); // [2,3]
-tail([1]); // [1]
+
const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
+
tail([1, 2, 3]); // [2,3]
+tail([1]); // [1]

truncateString

Truncates a string up to a specified length.

@@ -249,10 +218,11 @@ This method also works with strings.

Return the string truncated to the desired length, with '...' appended to the end or the original string.

const truncateString = (str, num) =>
   str.length > num ? str.slice(0, num > 3 ? num - 3 : num) + '...' : str;
-
truncateString('boomerang', 7); // 'boom...'
+
truncateString('boomerang', 7); // 'boom...'
+ \ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index a2d654366..83c8f824a 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -195,6 +195,12 @@ try { '' + ''; + beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize operator nodes + beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize keyword nodes + beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + beginnerOutput += `${beginnerEndPart}`; diff --git a/static-parts/beginner-page-end.html b/static-parts/beginner-page-end.html index 8c5b3ff89..6c016eca2 100644 --- a/static-parts/beginner-page-end.html +++ b/static-parts/beginner-page-end.html @@ -1,5 +1,6 @@ + \ No newline at end of file diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index edd03d57e..3aed0c0b2 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -13,48 +13,17 @@ + }, false); + } + - + +

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

From 8a66ec0dc309d2d5e24bdf904d2b151d0fc6bf74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 14:29:58 +0200 Subject: [PATCH 16/36] =?UTF-8?q?=F0=9F=8E=A8=20=20GitHub=20logo=20color?= =?UTF-8?q?=20change?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- static-parts/beginner-page-start.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index 3aed0c0b2..f343224e0 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -23,7 +23,7 @@ - +

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

From eaa5e1d4cffc6f948aae34a3e5ab997e2d995c73 Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 15:54:51 +0300 Subject: [PATCH 17/36] Updated the landing page Functional daily picks --- docs/mini.css | 2 +- docs/mini/flavor.scss | 118 ++++++++----- static-parts/index.html | 360 ++++++++++++++++++++++------------------ static-parts/mini.css | 1 + 4 files changed, 278 insertions(+), 203 deletions(-) create mode 100644 static-parts/mini.css diff --git a/docs/mini.css b/docs/mini.css index 042d073ec..d60f2bc89 100644 --- a/docs/mini.css +++ b/docs/mini.css @@ -1 +1 @@ -:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2.index-section{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:1.25rem;color:#fff}@media screen and (max-width: 767px){#in-numbers{padding-bottom:1rem}}#in-numbers svg{fill:#fff}#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1.5rem}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}.pick.selected button.previous{position:absolute;top:50%;left:-1rem}.pick.selected button.previous>svg{margin-left:-0.0625rem}.pick.selected button.previous,.pick.selected button.next{border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s}.pick.selected button.previous>svg,.pick.selected button.next>svg{fill:#888;transition:all 0.3s}.pick.selected button.previous:hover,.pick.selected button.previous:focus,.pick.selected button.next:hover,.pick.selected button.next:focus{border-color:#aaa}.pick.selected button.previous:hover>svg,.pick.selected button.previous:focus>svg,.pick.selected button.next:hover>svg,.pick.selected button.next:focus>svg{fill:#444} +:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff} diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss index 6014a8318..c56b8030a 100644 --- a/docs/mini/flavor.scss +++ b/docs/mini/flavor.scss @@ -470,7 +470,11 @@ button#disclaimer-close{ #splash { height: auto; padding-bottom: 1.5rem; - background: linear-gradient(135deg, rgba(255,174,39,1) 0%,rgba(222,73,109,1) 100%); + background: linear-gradient( + 135deg, + rgba(255, 174, 39, 1) 0%, + rgba(222, 73, 109, 1) 100% + ); #logo { margin-top: 0; margin-left: -0.5rem; @@ -492,15 +496,16 @@ button#disclaimer-close{ margin-left: -0.5rem; > a { background: transparent; - border: 0.0625rem solid rgba(17,17,17,0.95); + border: 0.0625rem solid rgba(17, 17, 17, 0.95); transition: all 0.3s; - &:hover, &:focus { - background: rgba(17,17,17,0.95); + &:hover, + &:focus { + background: rgba(17, 17, 17, 0.95); color: #e86957; } } } - @media screen and (max-width:767px){ + @media screen and (max-width: 767px) { #logo { font-size: 1.75rem; img { @@ -515,7 +520,7 @@ button#disclaimer-close{ font-size: 0.875rem; } } - @media screen and (max-width: 383px){ + @media screen and (max-width: 383px) { #logo { font-size: 1.5rem; img { @@ -526,7 +531,7 @@ button#disclaimer-close{ padding: 0.125rem 5%; } } - @media screen and (max-width: 479px){ + @media screen and (max-width: 479px) { #tagline #tagline-lg { display: none; } @@ -553,7 +558,7 @@ h2 { #license-icon { text-align: center; - @media screen and (min-width: 768px){ + @media screen and (min-width: 768px) { position: relative; top: calc(50% - 40px); } @@ -580,7 +585,7 @@ h2 { color: #fff; svg { fill: #fff; - @media screen and (min-width: 768px){ + @media screen and (min-width: 768px) { position: relative; top: 20px; left: -34px; @@ -590,7 +595,7 @@ h2 { } p { overflow-wrap: break-word; - @media screen and (min-width: 768px){ + @media screen and (min-width: 768px) { position: relative; top: -24px; left: 22px; @@ -602,9 +607,12 @@ h2 { } } -#snippet-count, #contrib-count, #commit-count, #test-count { +#snippet-count, +#contrib-count, +#commit-count, +#test-count { font-size: 1rem; - @media screen and (min-width: 768px){ + @media screen and (min-width: 768px) { font-size: 1.25rem; } } @@ -621,6 +629,15 @@ ul#links { display: none; } +.card.pick { + transition: all 0.6s; + left: 0; +} + +.card.pick + .card.pick { + margin-top: 0.5rem; +} + .pick.selected { overflow: visible; button.next { @@ -631,32 +648,47 @@ ul#links { margin-right: -0.0625rem; } } - button.previous { - position: absolute; - top: 50%; - left: -1rem; - > svg { - margin-left: -0.0625rem; - } +} + +#pick-slider { + position: relative; +} + +button.previous { + left: -1%; + > svg { + margin-left: -0.125rem; } - button.previous, button.next { - border-radius: 100%; - background: #f8f8f8; - border: 0.03125rem solid #ddd; - width: 1.5rem; - height: 1.5rem; - padding: 0; - margin: 0; +} +button.next { + right: -1%; + > svg { + margin-left: 0.0625rem; + } +} + +button.previous, +button.next { + position: absolute; + top: 50%; + border-radius: 100%; + background: #f8f8f8; + border: 0.03125rem solid #ddd; + width: 1.5rem; + height: 1.5rem; + padding: 0; + margin: 0; + transition: all 0.3s; + z-index: 2000; + > svg { + fill: #888; transition: all 0.3s; + } + &:hover, + &:focus { + border-color: #aaa; > svg { - fill: #888; - transition: all 0.3s; - } - &:hover, &:focus { - border-color: #aaa; - > svg { - fill: #444; - } + fill: #444; } } } @@ -672,7 +704,8 @@ ul#links { font-weight: 700; text-align: center; transition: color 0.3s; - &:hover, &:focus { + &:hover, + &:focus { color: var(--a-l-col); background: #f8f8f8; } @@ -690,8 +723,9 @@ ul#links { } .contribution-guideline + .contribution-guideline { - &:before, &:after { - content: ''; + &:before, + &:after { + content: ""; position: relative; top: -2.75rem; width: 0.375rem; @@ -700,7 +734,7 @@ ul#links { border: 0.03125rem solid #d0d0d0; border-radius: 100%; left: calc(50% - 0.1875rem); - box-shadow: inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05); + box-shadow: inset -0.03125rem -0.03125rem 0.03125rem rgba(0, 0, 0, 0.05); } &:after { position: absolute; @@ -713,7 +747,11 @@ ul#links { top: -1.125rem; left: calc(50% - 1.125rem); font-size: 1.5rem; - background: linear-gradient(135deg, rgba(255,174,39,1) 0%,rgba(222,73,109,1) 100%); + background: linear-gradient( + 135deg, + rgba(255, 174, 39, 1) 0%, + rgba(222, 73, 109, 1) 100% + ); border: 0.03125 solid #ddd; width: 2.25rem; text-align: center; diff --git a/static-parts/index.html b/static-parts/index.html index c26ecdbe5..f416b3dfb 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -15,175 +15,179 @@
-

logo 30 seconds of code

-

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

- -
-
-
-
-
- -

295
snippets

-
-
- -

114
contributors

-
-
- -

3028
commits

-
-
- -

999
tests

-
-
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+ +
+
+
+
+
+ +

295
snippets

+
+
+ +

114
contributors

+
+
+ +

3028
commits

+
+
+ +

999
tests

-
-
-
-

Our philosophy

-

The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


+
+
+
+
+
+

Our philosophy

+

The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


+
+
+
+
+
+
+
+
+

In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

-
+

+
+
+
+
+

Today's picks

+
+ + +
+

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
+  document.documentElement.clientHeight + window.scrollY >=
+  (document.documentElement.scrollHeight || document.documentElement.clientHeight);
+
bottomVisible(); // true
+
+

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
+
const firstTwoMax = ary(Math.max, 2);
+[[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
+
+
+
+
+
+
+
+
+
+

Getting started

+
+
+
+
+
+

Related projects

+

The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

+
+
+
+
+
+

Top contributors

-
-
-
-
-
-

In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

+
+ + Angelos Chalaris +
+
+
+ + Stefan Feješ +
+
+ + Felix Wu +
+
+ + atomiks +
+
+ + King David Martins +
+
+ + Rohit Tanwar +
+
+ + Soorena Soleimani +
+
+ + Robert Mennell +
+
+
+
+
+
+

How to contribute

+

Do you have a cool idea for a new snippet? Maybe some code you use often and is not part of our collection? Contributing to 30 seconds of code is as simple as 1,2,3,4!

+
+ 1 +
+

Create

+

Start by creating a snippet, according to the snippet template. Make sure to follow these simple guidelines:

+
    +
  • Your snippet title must be unique and the same as the name of the implemented function.
    • +
  • Use the snippet description to explain what your snippet does and how it works.
    • +
  • Try to keep the snippet's code short and to the point. Use modern techniques and features.
    • +
  • Remember to provide an example of how your snippet works.
    • +
  • Your snippet should solve a real-world problem, no matter how simple.
    • +
  • Never modify README.md or any of the HTML files.
    • +
-

-
-
-
-
-

Today's picks

-
- -

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
-      document.documentElement.clientHeight + window.scrollY >=
-      (document.documentElement.scrollHeight || document.documentElement.clientHeight);
-    
bottomVisible(); // true
-
-

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
-    
const firstTwoMax = ary(Math.max, 2);
-    [[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
-
-
-
-
-
-
-
-
-

Getting started

-
-
-
-
-
-

Related projects

-

The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

-
-
-
-
-
-

Top contributors

-
-
- - Angelos Chalaris -
+
+
+ 2 +
+

Tag

+

Run npm run tagger from your terminal, then open the tag_database file and tag your snippet appropriately. Multitagging is also supported, just make sure the first tag you specify is on of the major tags and the one that is most relevant to the implemneted function.

-
- - Stefan Feješ -
-
- - Felix Wu -
-
- - atomiks -
-
- - King David Martins -
-
- - Rohit Tanwar -
-
- - Soorena Soleimani -
-
- - Robert Mennell -
-
-
-
-
-
-

How to contribute

-

Do you have a cool idea for a new snippet? Maybe some code you use often and is not part of our collection? Contributing to 30 seconds of code is as simple as 1,2,3,4!

-
- 1 -
-

Create

-

Start by creating a snippet, according to the snippet template. Make sure to follow these simple guidelines:

-
    -
  • Your snippet title must be unique and the same as the name of the implemented function.
    • -
  • Use the snippet description to explain what your snippet does and how it works.
    • -
  • Try to keep the snippet's code short and to the point. Use modern techniques and features.
    • -
  • Remember to provide an example of how your snippet works.
    • -
  • Your snippet should solve a real-world problem, no matter how simple.
    • -
  • Never modify README.md or any of the HTML files.
    • -
-
-
-
- 2 -
-

Tag

-

Run npm run tagger from your terminal, then open the tag_database file and tag your snippet appropriately. Multitagging is also supported, just make sure the first tag you specify is on of the major tags and the one that is most relevant to the implemneted function.

-
-
-
- 3 -
-

Test

-

You can optionally test your snippet to make our job easier. Simply run npm run tester to generate the test files for your snippet. Find the related folder for you snippet under the test directory and write some tests. Remember to run npm run tester again to make sure your tests are passing.

-
-
-
- 4 -
-

Pull request

-

If you have done everything mentioned above, you should now have an awesome snippet to add to our collection. Simply start a pull request and follow the guidelines provided. Remember to only submit one snippet per pull request, so that we can quickly evaluate and merge your code into the collection.

-
-
-

If you need additional pointers about writing a snippet, be sure to read the complete contribution guidelines.

+
+
+ 3 +
+

Test

+

You can optionally test your snippet to make our job easier. Simply run npm run tester to generate the test files for your snippet. Find the related folder for you snippet under the test directory and write some tests. Remember to run npm run tester again to make sure your tests are passing.

-
-
- +
+
+ 4 +
+

Pull request

+

If you have done everything mentioned above, you should now have an awesome snippet to add to our collection. Simply start a pull request and follow the guidelines provided. Remember to only submit one snippet per pull request, so that we can quickly evaluate and merge your code into the collection.

+
+
+

If you need additional pointers about writing a snippet, be sure to read the complete contribution guidelines.

+
+
+
+
+ diff --git a/static-parts/mini.css b/static-parts/mini.css new file mode 100644 index 000000000..d60f2bc89 --- /dev/null +++ b/static-parts/mini.css @@ -0,0 +1 @@ +:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff} From ec115f0021057ad9307a42660fcab0b4c810ed9d Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 15:57:40 +0300 Subject: [PATCH 18/36] Fixed one snippet name not working last.md should now be part of the beginner page --- docs/beginner.html | 8 +++++++- scripts/web.js | 2 +- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/beginner.html b/docs/beginner.html index 5aa9a67aa..60d04d2b9 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -23,7 +23,7 @@ - +

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

@@ -134,6 +134,12 @@ Return false if any of them divides the given number, else return < }; 
isPrime(11); // true
+

last

+

Returns the last element in an array.

+

Use arr.length - 1 to compute the index of the last element of the given array and returning it.

+
const last = arr => arr[arr.length - 1];
+
last([1, 2, 3]); // 3
+

lcm

Returns the least common multiple of two or more numbers.

Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. diff --git a/scripts/web.js b/scripts/web.js index 83c8f824a..b1daa7c50 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -51,7 +51,7 @@ const snippetsPath = './snippets', docsPath = './docs'; // Set variables for script let snippets = {}, - beginnerSnippetNames = ['everyNth', 'filterNonUnique', 'last.md', 'maxN', 'minN', 'nthElement', 'sample', 'similarity', 'tail', 'currentURL', 'hasClass', 'getMeridiemSuffixOfInteger', 'factorial', 'fibonacci', 'gcd', 'isDivisible', 'isEven', 'isPrime', 'lcm', 'randomIntegerInRange', 'sum', 'reverseString', 'truncateString'], + beginnerSnippetNames = ['everyNth', 'filterNonUnique', 'last', 'maxN', 'minN', 'nthElement', 'sample', 'similarity', 'tail', 'currentURL', 'hasClass', 'getMeridiemSuffixOfInteger', 'factorial', 'fibonacci', 'gcd', 'isDivisible', 'isEven', 'isPrime', 'lcm', 'randomIntegerInRange', 'sum', 'reverseString', 'truncateString'], startPart = '', endPart = '', output = '', From 015ac2d96c47d793790c275e482629c15ee0fe57 Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 16:07:40 +0300 Subject: [PATCH 19/36] Updated test count to star count --- docs/mini.css | 2 +- docs/mini/flavor.scss | 2 +- static-parts/index.html | 10 +++++----- static-parts/mini.css | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/mini.css b/docs/mini.css index d60f2bc89..3a0a6c1c1 100644 --- a/docs/mini.css +++ b/docs/mini.css @@ -1 +1 @@ -:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#test-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff} +:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a— " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff} diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss index c56b8030a..81b81020c 100644 --- a/docs/mini/flavor.scss +++ b/docs/mini/flavor.scss @@ -610,7 +610,7 @@ h2 { #snippet-count, #contrib-count, #commit-count, -#test-count { +#star-count { font-size: 1rem; @media screen and (min-width: 768px) { font-size: 1.25rem; diff --git a/static-parts/index.html b/static-parts/index.html index f416b3dfb..00d8a3b14 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -35,8 +35,8 @@

3028
commits

- -

999
tests

+ +

19459
stars

@@ -190,9 +190,9 @@ + - +

logo 30 seconds of code

diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index f343224e0..f2a219cd5 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -13,16 +13,68 @@ + - +

logo 30 seconds of code

From 9bd447b8dbbde4a0acae7b2871806db9b0c81225 Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 16:30:56 +0300 Subject: [PATCH 21/36] Fixed scrolling to top for beginner page --- docs/beginner.html | 4 ++-- static-parts/beginner-page-start.html | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/beginner.html b/docs/beginner.html index 1384f7d2e..7f7d25fb8 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -14,10 +14,10 @@

⚠️ WARNING: Snippets are not production ready.

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Adapter

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
-
const firstTwoMax = ary(Math.max, 2);
-[[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
-

call

Given a key and a set of arguments, call them when given a context. Primarily useful in composition.

Use a closure to call a stored key with stored arguments.

const call = (key, ...args) => context => context[key](...args);
-
Promise.resolve([1, 2, 3])
-  .then(call('map', x => 2 * x))
-  .then(console.log); //[ 2, 4, 6 ]
-const map = call.bind(null, 'map');
-Promise.resolve([1, 2, 3])
-  .then(map(x => 2 * x))
-  .then(console.log); //[ 2, 4, 6 ]
-

collectInto

Changes a function that accepts an array into a variadic function.

Given a function, return a closure that collects all inputs into an array-accepting function.

const collectInto = fn => (...args) => fn(args);
-
const Pall = collectInto(Promise.all.bind(Promise));
-let p1 = Promise.resolve(1);
-let p2 = Promise.resolve(2);
-let p3 = new Promise(resolve => setTimeout(resolve, 2000, 3));
-Pall(p1, p2, p3).then(console.log); // [1, 2, 3] (after about 2 seconds)
-

flip

Flip takes a function as an argument, then makes the first argument the last.

Return a closure that takes variadic inputs, and splices the last argument to make it the first argument before applying the rest.

const flip = fn => (first, ...rest) => fn(...rest, first);
-
let a = { name: 'John Smith' };
-let b = {};
-const mergeFrom = flip(Object.assign);
-let mergePerson = mergeFrom.bind(null, a);
-mergePerson(b); // == b
-b = {};
-Object.assign(b, a); // == b
-

over

Creates a function that invokes each provided function with the arguments it receives and returns the results.

Use Array.map() and Function.apply() to apply each function to the given arguments.

const over = (...fns) => (...args) => fns.map(fn => fn.apply(null, args));
-
const minMax = over(Math.min, Math.max);
-minMax(1, 2, 3, 4, 5); // [1,5]
-

overArgs

Creates a function that invokes the provided function with its arguments transformed.

Use Array.map() to apply transforms to args in combination with the spread operator (...) to pass the transformed arguments to fn.

const overArgs = (fn, transforms) => (...args) => fn(...args.map((val, i) => transforms[i](val)));
-
const square = n => n * n;
-const double = n => n * 2;
-const fn = overArgs((x, y) => [x, y], [square, double]);
-fn(9, 3); // [81, 6]
-

pipeAsyncFunctions

Performs left-to-right function composition for asynchronous functions.

Use Array.reduce() with the spread operator (...) to perform left-to-right function composition using Promise.then(). The functions can return a combination of: simple values, Promise's, or they can be defined as async ones returning through await. All functions must be unary.

const pipeAsyncFunctions = (...fns) => arg => fns.reduce((p, f) => p.then(f), Promise.resolve(arg));
-
const sum = pipeAsyncFunctions(
-  x => x + 1,
-  x => new Promise(resolve => setTimeout(() => resolve(x + 2), 1000)),
-  x => x + 3,
-  async x => (await x) + 4
-);
-(async () => {
-  console.log(await sum(5)); // 15 (after one second)
-})();
-

pipeFunctions

Performs left-to-right function composition.

Use Array.reduce() with the spread operator (...) to perform left-to-right function composition. The first (leftmost) function can accept one or more arguments; the remaining functions must be unary.

const pipeFunctions = (...fns) => fns.reduce((f, g) => (...args) => g(f(...args)));
-
const add5 = x => x + 5;
-const multiply = (x, y) => x * y;
-const multiplyAndAdd5 = pipeFunctions(multiply, add5);
-multiplyAndAdd5(5, 2); // 15
-

promisify

Converts an asynchronous function to return a promise.

Use currying to return a function returning a Promise that calls the original function. Use the ...rest operator to pass in all the parameters.

In Node 8+, you can use util.promisify

const promisify = func => (...args) =>
-  new Promise((resolve, reject) =>
-    func(...args, (err, result) => (err ? reject(err) : resolve(result)))
-  );
-
const delay = promisify((d, cb) => setTimeout(cb, d));
-delay(2000).then(() => console.log('Hi!')); // // Promise resolves after 2s
-

rearg

Creates a function that invokes the provided function with its arguments arranged according to the specified indexes.

Use Array.reduce() and Array.indexOf() to reorder arguments based on indexes in combination with the spread operator (...) to pass the transformed arguments to fn.

const rearg = (fn, indexes) => (...args) =>
-  fn(
-    ...args.reduce(
-      (acc, val, i) => ((acc[indexes.indexOf(i)] = val), acc),
-      Array.from({ length: indexes.length })
-    )
-  );
-
var rearged = rearg(
-  function(a, b, c) {
-    return [a, b, c];
-  },
-  [2, 0, 1]
-);
-rearged('b', 'c', 'a'); // ['a', 'b', 'c']
-

spreadOver

Takes a variadic function and returns a closure that accepts an array of arguments to map to the inputs of the function.

Use closures and the spread operator (...) to map the array of arguments to the inputs of the function.

const spreadOver = fn => argsArr => fn(...argsArr);
-
const arrayMax = spreadOver(Math.max);
-arrayMax([1, 2, 3]); // 3
-

unary

Creates a function that accepts up to one argument, ignoring any additional arguments.

Call the provided function, fn, with just the first argument given.

const unary = fn => val => fn(val);
-
['6', '8', '10'].map(unary(parseInt)); // [6, 8, 10]
-

Array

all

Returns true if the provided predicate function returns true for all elements in a collection, false otherwise.

Use Array.every() to test if all elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.

const all = (arr, fn = Boolean) => arr.every(fn);
-
all([4, 2, 3], x => x > 1); // true
-all([1, 2, 3]); // true
-

any

Returns true if the provided predicate function returns true for at least one element in a collection, false otherwise.

Use Array.some() to test if any elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.

const any = (arr, fn = Boolean) => arr.some(fn);
-
any([0, 1, 2, 0], x => x >= 2); // true
-any([0, 0, 1, 0]); // true
-

bifurcate

Splits values into two groups. If an element in filter is truthy, the corresponding element in the collection belongs to the first group; otherwise, it belongs to the second group.

Use Array.reduce() and Array.push() to add elements to groups, based on filter.

const bifurcate = (arr, filter) =>
-  arr.reduce((acc, val, i) => (acc[filter[i] ? 0 : 1].push(val), acc), [[], []]);
-
bifurcate(['beep', 'boop', 'foo', 'bar'], [true, true, false, true]); // [ ['beep', 'boop', 'bar'], ['foo'] ]
-

bifurcateBy

Splits values into two groups according to a predicate function, which specifies which group an element in the input collection belongs to. If the predicate function returns a truthy value, the collection element belongs to the first group; otherwise, it belongs to the second group.

Use Array.reduce() and Array.push() to add elements to groups, based on the value returned by fn for each element.

const bifurcateBy = (arr, fn) =>
-  arr.reduce((acc, val, i) => (acc[fn(val, i) ? 0 : 1].push(val), acc), [[], []]);
-
bifurcateBy(['beep', 'boop', 'foo', 'bar'], x => x[0] === 'b'); // [ ['beep', 'boop', 'bar'], ['foo'] ]
-

chunk

Chunks an array into smaller arrays of a specified size.

Use Array.from() to create a new array, that fits the number of chunks that will be produced. Use Array.slice() to map each element of the new array to a chunk the length of size. If the original array can't be split evenly, the final chunk will contain the remaining elements.

const chunk = (arr, size) =>
-  Array.from({ length: Math.ceil(arr.length / size) }, (v, i) =>
-    arr.slice(i * size, i * size + size)
-  );
-
chunk([1, 2, 3, 4, 5], 2); // [[1,2],[3,4],[5]]
-

compact

Removes falsey values from an array.

Use Array.filter() to filter out falsey values (false, null, 0, "", undefined, and NaN).

const compact = arr => arr.filter(Boolean);
-
compact([0, 1, false, 2, '', 3, 'a', 'e' * 23, NaN, 's', 34]); // [ 1, 2, 3, 'a', 's', 34 ]
-

countBy

Groups the elements of an array based on the given function and returns the count of elements in each group.

Use Array.map() to map the values of an array to a function or property name. Use Array.reduce() to create an object, where the keys are produced from the mapped results.

const countBy = (arr, fn) =>
-  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val, i) => {
-    acc[val] = (acc[val] || 0) + 1;
-    return acc;
-  }, {});
-
countBy([6.1, 4.2, 6.3], Math.floor); // {4: 1, 6: 2}
-countBy(['one', 'two', 'three'], 'length'); // {3: 2, 5: 1}
-

countOccurrences

Counts the occurrences of a value in an array.

Use Array.reduce() to increment a counter each time you encounter the specific value inside the array.

const countOccurrences = (arr, val) => arr.reduce((a, v) => (v === val ? a + 1 : a + 0), 0);
-
countOccurrences([1, 1, 2, 1, 2, 3], 1); // 3
-

deepFlatten

Deep flattens an array.

Use recursion. Use Array.concat() with an empty array ([]) and the spread operator (...) to flatten an array. Recursively flatten each element that is an array.

const deepFlatten = arr => [].concat(...arr.map(v => (Array.isArray(v) ? deepFlatten(v) : v)));
-
deepFlatten([1, [2], [[3], 4], 5]); // [1,2,3,4,5]
-

difference

Returns the difference between two arrays.

Create a Set from b, then use Array.filter() on a to only keep values not contained in b.

const difference = (a, b) => {
-  const s = new Set(b);
-  return a.filter(x => !s.has(x));
-};
-
difference([1, 2, 3], [1, 2, 4]); // [3]
-

differenceBy

Returns the difference between two arrays, after applying the provided function to each array element of both.

Create a Set by applying fn to each element in b, then use Array.filter() in combination with fn on a to only keep values not contained in the previously created set.

const differenceBy = (a, b, fn) => {
-  const s = new Set(b.map(v => fn(v)));
-  return a.filter(x => !s.has(fn(x)));
-};
-
differenceBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [1.2]
-differenceBy([{ x: 2 }, { x: 1 }], [{ x: 1 }], v => v.x); // [ { x: 2 } ]
-

differenceWith

Filters out all values from an array for which the comparator function does not return true.

Use Array.filter() and Array.findIndex() to find the appropriate values.

const differenceWith = (arr, val, comp) => arr.filter(a => val.findIndex(b => comp(a, b)) === -1);
-
differenceWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0], (a, b) => Math.round(a) === Math.round(b)); // [1, 1.2]
-

drop

Returns a new array with n elements removed from the left.

Use Array.slice() to slice the remove the specified number of elements from the left.

const drop = (arr, n = 1) => arr.slice(n);
-
drop([1, 2, 3]); // [2,3]
-drop([1, 2, 3], 2); // [3]
-drop([1, 2, 3], 42); // []
-

dropRight

Returns a new array with n elements removed from the right.

Use Array.slice() to slice the remove the specified number of elements from the right.

const dropRight = (arr, n = 1) => arr.slice(0, -n);
-
dropRight([1, 2, 3]); // [1,2]
-dropRight([1, 2, 3], 2); // [1]
-dropRight([1, 2, 3], 42); // []
-

dropRightWhile

Removes elements from the end of an array until the passed function returns true. Returns the remaining elements in the array.

Loop through the array, using Array.slice() to drop the last element of the array until the returned value from the function is true. Returns the remaining elements.

const dropRightWhile = (arr, func) => {
-  while (arr.length > 0 && !func(arr[arr.length - 1])) arr = arr.slice(0, -1);
-  return arr;
-};
-
dropRightWhile([1, 2, 3, 4], n => n < 3); // [1, 2]
-

dropWhile

Removes elements in an array until the passed function returns true. Returns the remaining elements in the array.

Loop through the array, using Array.slice() to drop the first element of the array until the returned value from the function is true. Returns the remaining elements.

const dropWhile = (arr, func) => {
-  while (arr.length > 0 && !func(arr[0])) arr = arr.slice(1);
-  return arr;
-};
-
dropWhile([1, 2, 3, 4], n => n >= 3); // [3,4]
-

everyNth

Returns every nth element in an array.

Use Array.filter() to create a new array that contains every nth element of a given array.

const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
-
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
-

filterNonUnique

Filters out the non-unique values in an array.

Use Array.filter() for an array containing only the unique values.

const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
-
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]
-

findLast

Returns the last element for which the provided function returns a truthy value.

Use Array.filter() to remove elements for which fn returns falsey values, Array.slice(-1) to get the last one.

const findLast = (arr, fn) => arr.filter(fn).slice(-1)[0];
-
findLast([1, 2, 3, 4], n => n % 2 === 1); // 3
-

findLastIndex

Returns the index of the last element for which the provided function returns a truthy value.

Use Array.map() to map each element to an array with its index and value. Use Array.filter() to remove elements for which fn returns falsey values, Array.slice(-1) to get the last one.

const findLastIndex = (arr, fn) =>
-  arr
-    .map((val, i) => [i, val])
-    .filter(val => fn(val[1], val[0], arr))
-    .slice(-1)[0][0];
-
findLastIndex([1, 2, 3, 4], n => n % 2 === 1); // 2 (index of the value 3)
-

flatten

Flattens an array up to the specified depth.

Use recursion, decrementing depth by 1 for each level of depth. Use Array.reduce() and Array.concat() to merge elements or arrays. Base case, for depth equal to 1 stops recursion. Omit the second argument, depth to flatten only to a depth of 1 (single flatten).

const flatten = (arr, depth = 1) =>
-  arr.reduce((a, v) => a.concat(depth > 1 && Array.isArray(v) ? flatten(v, depth - 1) : v), []);
-
flatten([1, [2], 3, 4]); // [1, 2, 3, 4]
-flatten([1, [2, [3, [4, 5], 6], 7], 8], 2); // [1, 2, 3, [4, 5], 6, 7, 8]
-

forEachRight

Executes a provided function once for each array element, starting from the array's last element.

Use Array.slice(0) to clone the given array, Array.reverse() to reverse it and Array.forEach() to iterate over the reversed array.

const forEachRight = (arr, callback) =>
-  arr
-    .slice(0)
-    .reverse()
-    .forEach(callback);
-
forEachRight([1, 2, 3, 4], val => console.log(val)); // '4', '3', '2', '1'
-

groupBy

Groups the elements of an array based on the given function.

Use Array.map() to map the values of an array to a function or property name. Use Array.reduce() to create an object, where the keys are produced from the mapped results.

const groupBy = (arr, fn) =>
-  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val, i) => {
-    acc[val] = (acc[val] || []).concat(arr[i]);
-    return acc;
-  }, {});
-
groupBy([6.1, 4.2, 6.3], Math.floor); // {4: [4.2], 6: [6.1, 6.3]}
-groupBy(['one', 'two', 'three'], 'length'); // {3: ['one', 'two'], 5: ['three']}
-

Returns the head of a list.

Use arr[0] to return the first element of the passed array.

const head = arr => arr[0];
-
head([1, 2, 3]); // 1
-

indexOfAll

Returns all indices of val in an array. If val never occurs, returns [].

Use Array.forEach() to loop over elements and Array.push() to store indices for matching elements. Return the array of indices.

const indexOfAll = (arr, val) => {
-  const indices = [];
-  arr.forEach((el, i) => el === val && indices.push(i));
-  return indices;
-};
-
indexOfAll([1, 2, 3, 1, 2, 3], 1); // [0,3]
-indexOfAll([1, 2, 3], 4); // []
-

initial

Returns all the elements of an array except the last one.

Use arr.slice(0,-1) to return all but the last element of the array.

const initial = arr => arr.slice(0, -1);
-
initial([1, 2, 3]); // [1,2]
-

initialize2DArray

Initializes a 2D array of given width and height and value.

Use Array.map() to generate h rows where each is a new array of size w initialize with value. If the value is not provided, default to null.

const initialize2DArray = (w, h, val = null) =>
-  Array.from({ length: h }).map(() => Array.from({ length: w }).fill(val));
-
initialize2DArray(2, 2, 0); // [[0,0], [0,0]]
-

initializeArrayWithRange

Initializes an array containing the numbers in the specified range where start and end are inclusive with their common difference step.

Use Array.from(Math.ceil((end+1-start)/step)) to create an array of the desired length(the amounts of elements is equal to (end-start)/step or (end+1-start)/step for inclusive end), Array.map() to fill with the desired values in a range. You can omit start to use a default value of 0. You can omit step to use a default value of 1.

const initializeArrayWithRange = (end, start = 0, step = 1) =>
-  Array.from({ length: Math.ceil((end + 1 - start) / step) }).map((v, i) => i * step + start);
-
initializeArrayWithRange(5); // [0,1,2,3,4,5]
-initializeArrayWithRange(7, 3); // [3,4,5,6,7]
-initializeArrayWithRange(9, 0, 2); // [0,2,4,6,8]
-

initializeArrayWithRangeRight

Initializes an array containing the numbers in the specified range (in reverse) where start and end are inclusive with their common difference step.

Use Array.from(Math.ceil((end+1-start)/step)) to create an array of the desired length(the amounts of elements is equal to (end-start)/step or (end+1-start)/step for inclusive end), Array.map() to fill with the desired values in a range. You can omit start to use a default value of 0. You can omit step to use a default value of 1.

const initializeArrayWithRangeRight = (end, start = 0, step = 1) =>
-  Array.from({ length: Math.ceil((end + 1 - start) / step) }).map(
-    (v, i, arr) => (arr.length - i - 1) * step + start
-  );
-
initializeArrayWithRangeRight(5); // [5,4,3,2,1,0]
-initializeArrayWithRangeRight(7, 3); // [7,6,5,4,3]
-initializeArrayWithRangeRight(9, 0, 2); // [8,6,4,2,0]
-

initializeArrayWithValues

Initializes and fills an array with the specified values.

Use Array(n) to create an array of the desired length, fill(v) to fill it with the desired values. You can omit val to use a default value of 0.

const initializeArrayWithValues = (n, val = 0) => Array(n).fill(val);
-
initializeArrayWithValues(5, 2); // [2,2,2,2,2]
-

intersection

Returns a list of elements that exist in both arrays.

Create a Set from b, then use Array.filter() on a to only keep values contained in b.

const intersection = (a, b) => {
-  const s = new Set(b);
-  return a.filter(x => s.has(x));
-};
-
intersection([1, 2, 3], [4, 3, 2]); // [2,3]
-

intersectionBy

Returns a list of elements that exist in both arrays, after applying the provided function to each array element of both.

Create a Set by applying fn to all elements in b, then use Array.filter() on a to only keep elements, which produce values contained in b when fn is applied to them.

const intersectionBy = (a, b, fn) => {
-  const s = new Set(b.map(x => fn(x)));
-  return a.filter(x => s.has(fn(x)));
-};
-
intersectionBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [2.1]
-

intersectionWith

Returns a list of elements that exist in both arrays, using a provided comparator function.

Use Array.filter() and Array.findIndex() in combination with the provided comparator to determine intersecting values.

const intersectionWith = (a, b, comp) => a.filter(x => b.findIndex(y => comp(x, y)) !== -1);
-
intersectionWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0, 3.9], (a, b) => Math.round(a) === Math.round(b)); // [1.5, 3, 0]
-

isSorted

Returns 1 if the array is sorted in ascending order, -1 if it is sorted in descending order or 0 if it is not sorted.

Calculate the ordering direction for the first two elements. Use Object.entries() to loop over array objects and compare them in pairs. Return 0 if the direction changes or the direction if the last element is reached.

const isSorted = arr => {
-  let direction = -(arr[0] - arr[1]);
-  for (let [i, val] of arr.entries()) {
-    direction = !direction ? -(arr[i - 1] - arr[i]) : direction;
-    if (i === arr.length - 1) return !direction ? 0 : direction;
-    else if ((val - arr[i + 1]) * direction > 0) return 0;
-  }
-};
-
isSorted([0, 1, 2, 2]); // 1
-isSorted([4, 3, 2]); // -1
-isSorted([4, 3, 5]); // 0
-

join

Joins all elements of an array into a string and returns this string. Uses a separator and an end separator.

Use Array.reduce() to combine elements into a string. Omit the second argument, separator, to use a default separator of ','. Omit the third argument, end, to use the same value as separator by default.

const join = (arr, separator = ',', end = separator) =>
-  arr.reduce(
-    (acc, val, i) =>
-      i === arr.length - 2
-        ? acc + val + end
-        : i === arr.length - 1 ? acc + val : acc + val + separator,
-    ''
-  );
-
join(['pen', 'pineapple', 'apple', 'pen'], ',', '&'); // "pen,pineapple,apple&pen"
-join(['pen', 'pineapple', 'apple', 'pen'], ','); // "pen,pineapple,apple,pen"
-join(['pen', 'pineapple', 'apple', 'pen']); // "pen,pineapple,apple,pen"
-

last

Returns the last element in an array.

Use arr.length - 1 to compute the index of the last element of the given array and returning it.

const last = arr => arr[arr.length - 1];
-
last([1, 2, 3]); // 3
-

longestItem

Takes any number of iterable objects or objects with a length property and returns the longest one.

Use Array.sort() to sort all arguments by length, return the first (longest) one.

const longestItem = (...vals) => [...vals].sort((a, b) => b.length - a.length)[0];
-
longestItem('this', 'is', 'a', 'testcase'); // 'testcase'
-longestItem(...['a', 'ab', 'abc']); // 'abc'
-longestItem(...['a', 'ab', 'abc'], 'abcd'); // 'abcd'
-longestItem([1, 2, 3], [1, 2], [1, 2, 3, 4, 5]); // [1, 2, 3, 4, 5]
-longestItem([1, 2, 3], 'foobar'); // 'foobar'
-

mapObjectadvanced

Maps the values of an array to an object using a function, where the key-value pairs consist of the original value as the key and the mapped value.

Use an anonymous inner function scope to declare an undefined memory space, using closures to store a return value. Use a new Array to store the array with a map of the function over its data set and a comma operator to return a second step, without needing to move from one context to another (due to closures and order of operations).

const mapObject = (arr, fn) =>
-  (a => (
-    (a = [arr, arr.map(fn)]), a[0].reduce((acc, val, ind) => ((acc[val] = a[1][ind]), acc), {})
-  ))();
-
const squareIt = arr => mapObject(arr, a => a * a);
-squareIt([1, 2, 3]); // { 1: 1, 2: 4, 3: 9 }
-

maxN

Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.

const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
-
maxN([1, 2, 3]); // [3]
-maxN([1, 2, 3], 2); // [3,2]
-

minN

Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).

Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.

const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
-
minN([1, 2, 3]); // [1]
-minN([1, 2, 3], 2); // [1,2]
-

none

Returns true if the provided predicate function returns false for all elements in a collection, false otherwise.

Use Array.some() to test if any elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.

const none = (arr, fn = Boolean) => !arr.some(fn);
-
none([0, 1, 3, 0], x => x == 2); // true
-none([0, 0, 0]); // true
-

nthElement

Returns the nth element of an array.

Use Array.slice() to get an array containing the nth element at the first place. If the index is out of bounds, return []. Omit the second argument, n, to get the first element of the array.

const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
-
nthElement(['a', 'b', 'c'], 1); // 'b'
-nthElement(['a', 'b', 'b'], -3); // 'a'
-

partition

Groups the elements into two arrays, depending on the provided function's truthiness for each element.

Use Array.reduce() to create an array of two arrays. Use Array.push() to add elements for which fn returns true to the first array and elements for which fn returns false to the second one.

const partition = (arr, fn) =>
-  arr.reduce(
-    (acc, val, i, arr) => {
-      acc[fn(val, i, arr) ? 0 : 1].push(val);
-      return acc;
-    },
-    [[], []]
-  );
-
const users = [{ user: 'barney', age: 36, active: false }, { user: 'fred', age: 40, active: true }];
-partition(users, o => o.active); // [[{ 'user': 'fred',    'age': 40, 'active': true }],[{ 'user': 'barney',  'age': 36, 'active': false }]]
-

permutations

⚠️ WARNING: This function's execution time increases exponentially with each array element. Anything more than 8 to 10 entries will cause your browser to hang as it tries to solve all the different combinations.

Generates all permutations of an array's elements (contains duplicates).

Use recursion. For each element in the given array, create all the partial permutations for the rest of its elements. Use Array.map() to combine the element with each partial permutation, then Array.reduce() to combine all permutations in one array. Base cases are for array length equal to 2 or 1.

const permutations = arr => {
-  if (arr.length <= 2) return arr.length === 2 ? [arr, [arr[1], arr[0]]] : arr;
-  return arr.reduce(
-    (acc, item, i) =>
-      acc.concat(
-        permutations([...arr.slice(0, i), ...arr.slice(i + 1)]).map(val => [item, ...val])
-      ),
-    []
-  );
-};
-
permutations([1, 33, 5]); // [ [ 1, 33, 5 ], [ 1, 5, 33 ], [ 33, 1, 5 ], [ 33, 5, 1 ], [ 5, 1, 33 ], [ 5, 33, 1 ] ]
-

pull

Mutates the original array to filter out the values specified.

Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values.

(For a snippet that does not mutate the original array see without)

const pull = (arr, ...args) => {
-  let argState = Array.isArray(args[0]) ? args[0] : args;
-  let pulled = arr.filter((v, i) => !argState.includes(v));
-  arr.length = 0;
-  pulled.forEach(v => arr.push(v));
-};
-
let myArray = ['a', 'b', 'c', 'a', 'b', 'c'];
-pull(myArray, 'a', 'c'); // myArray = [ 'b', 'b' ]
-

pullAtIndex

Mutates the original array to filter out the values at the specified indexes.

Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values. Use Array.push() to keep track of pulled values

const pullAtIndex = (arr, pullArr) => {
-  let removed = [];
-  let pulled = arr
-    .map((v, i) => (pullArr.includes(i) ? removed.push(v) : v))
-    .filter((v, i) => !pullArr.includes(i));
-  arr.length = 0;
-  pulled.forEach(v => arr.push(v));
-  return removed;
-};
-
let myArray = ['a', 'b', 'c', 'd'];
-let pulled = pullAtIndex(myArray, [1, 3]); // myArray = [ 'a', 'c' ] , pulled = [ 'b', 'd' ]
-

pullAtValue

Mutates the original array to filter out the values specified. Returns the removed elements.

Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values. Use Array.push() to keep track of pulled values

const pullAtValue = (arr, pullArr) => {
-  let removed = [],
-    pushToRemove = arr.forEach((v, i) => (pullArr.includes(v) ? removed.push(v) : v)),
-    mutateTo = arr.filter((v, i) => !pullArr.includes(v));
-  arr.length = 0;
-  mutateTo.forEach(v => arr.push(v));
-  return removed;
-};
-
let myArray = ['a', 'b', 'c', 'd'];
-let pulled = pullAtValue(myArray, ['b', 'd']); // myArray = [ 'a', 'c' ] , pulled = [ 'b', 'd' ]
-

pullByadvanced

Mutates the original array to filter out the values specified, based on a given iterator function.

Check if the last argument provided in a function. Use Array.map() to apply the iterator function fn to all array elements. Use Array.filter() and Array.includes() to pull out the values that are not needed. Use Array.length = 0 to mutate the passed in an array by resetting it's length to zero and Array.push() to re-populate it with only the pulled values.

const pullBy = (arr, ...args) => {
-  const length = args.length;
-  let fn = length > 1 ? args[length - 1] : undefined;
-  fn = typeof fn == 'function' ? (args.pop(), fn) : undefined;
-  let argState = (Array.isArray(args[0]) ? args[0] : args).map(val => fn(val));
-  let pulled = arr.filter((v, i) => !argState.includes(fn(v)));
-  arr.length = 0;
-  pulled.forEach(v => arr.push(v));
-};
-
var myArray = [{ x: 1 }, { x: 2 }, { x: 3 }, { x: 1 }];
-pullBy(myArray, [{ x: 1 }, { x: 3 }], o => o.x); // myArray = [{ x: 2 }]
-

reducedFilter

Filter an array of objects based on a condition while also filtering out unspecified keys.

Use Array.filter() to filter the array based on the predicate fn so that it returns the objects for which the condition returned a truthy value. On the filtered array, use Array.map() to return the new object using Array.reduce() to filter out the keys which were not supplied as the keys argument.

const reducedFilter = (data, keys, fn) =>
-  data.filter(fn).map(el =>
-    keys.reduce((acc, key) => {
-      acc[key] = el[key];
-      return acc;
-    }, {})
-  );
-
const data = [
-  {
-    id: 1,
-    name: 'john',
-    age: 24
-  },
-  {
-    id: 2,
-    name: 'mike',
-    age: 50
-  }
-];
-
-reducedFilter(data, ['id', 'name'], item => item.age > 24); // [{ id: 2, name: 'mike'}]
-

reduceSuccessive

Applies a function against an accumulator and each element in the array (from left to right), returning an array of successively reduced values.

Use Array.reduce() to apply the given function to the given array, storing each new result.

const reduceSuccessive = (arr, fn, acc) =>
-  arr.reduce((res, val, i, arr) => (res.push(fn(res.slice(-1)[0], val, i, arr)), res), [acc]);
-
reduceSuccessive([1, 2, 3, 4, 5, 6], (acc, val) => acc + val, 0); // [0, 1, 3, 6, 10, 15, 21]
-

reduceWhich

Returns the minimum/maximum value of an array, after applying the provided function to set comparing rule.

Use Array.reduce() in combination with the comparator function to get the appropriate element in the array. You can omit the second parameter, comparator, to use the default one that returns the minimum element in the array.

const reduceWhich = (arr, comparator = (a, b) => a - b) =>
-  arr.reduce((a, b) => (comparator(a, b) >= 0 ? b : a));
-
reduceWhich([1, 3, 2]); // 1
-reduceWhich([1, 3, 2], (a, b) => b - a); // 3
-reduceWhich(
-  [{ name: 'Tom', age: 12 }, { name: 'Jack', age: 18 }, { name: 'Lucy', age: 9 }],
-  (a, b) => a.age - b.age
-); // {name: "Lucy", age: 9}
-

remove

Removes elements from an array for which the given function returns false.

Use Array.filter() to find array elements that return truthy values and Array.reduce() to remove elements using Array.splice(). The func is invoked with three arguments (value, index, array).

const remove = (arr, func) =>
-  Array.isArray(arr)
-    ? arr.filter(func).reduce((acc, val) => {
-        arr.splice(arr.indexOf(val), 1);
-        return acc.concat(val);
-      }, [])
-    : [];
-
remove([1, 2, 3, 4], n => n % 2 === 0); // [2, 4]
-

sample

Returns a random element from an array.

Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor(). This method also works with strings.

const sample = arr => arr[Math.floor(Math.random() * arr.length)];
-
sample([3, 7, 9, 11]); // 9
-

sampleSize

Gets n random elements at unique keys from array up to the size of array.

Shuffle the array using the Fisher-Yates algorithm. Use Array.slice() to get the first n elements. Omit the second argument, n to get only one element at random from the array.

const sampleSize = ([...arr], n = 1) => {
-  let m = arr.length;
-  while (m) {
-    const i = Math.floor(Math.random() * m--);
-    [arr[m], arr[i]] = [arr[i], arr[m]];
-  }
-  return arr.slice(0, n);
-};
-
sampleSize([1, 2, 3], 2); // [3,1]
-sampleSize([1, 2, 3], 4); // [2,3,1]
-

shuffle

Randomizes the order of the values of an array, returning a new array.

Uses the Fisher-Yates algorithm to reorder the elements of the array.

const shuffle = ([...arr]) => {
-  let m = arr.length;
-  while (m) {
-    const i = Math.floor(Math.random() * m--);
-    [arr[m], arr[i]] = [arr[i], arr[m]];
-  }
-  return arr;
-};
-
const foo = [1, 2, 3];
-shuffle(foo); // [2,3,1], foo = [1,2,3]
-

similarity

Returns an array of elements that appear in both arrays.

Use Array.filter() to remove values that are not part of values, determined using Array.includes().

const similarity = (arr, values) => arr.filter(v => values.includes(v));
-
similarity([1, 2, 3], [1, 2, 4]); // [1,2]
-

sortedIndex

Returns the lowest index at which value should be inserted into array in order to maintain its sort order.

Check if the array is sorted in descending order (loosely). Use Array.findIndex() to find the appropriate index where the element should be inserted.

const sortedIndex = (arr, n) => {
-  const isDescending = arr[0] > arr[arr.length - 1];
-  const index = arr.findIndex(el => (isDescending ? n >= el : n <= el));
-  return index === -1 ? arr.length : index;
-};
-
sortedIndex([5, 3, 2, 1], 4); // 1
-sortedIndex([30, 50], 40); // 1
-

sortedIndexBy

Returns the lowest index at which value should be inserted into array in order to maintain its sort order, based on a provided iterator function.

Check if the array is sorted in descending order (loosely). Use Array.findIndex() to find the appropriate index where the element should be inserted, based on the iterator function fn.

const sortedIndexBy = (arr, n, fn) => {
-  const isDescending = fn(arr[0]) > fn(arr[arr.length - 1]);
-  const val = fn(n);
-  const index = arr.findIndex(el => (isDescending ? val >= fn(el) : val <= fn(el)));
-  return index === -1 ? arr.length : index;
-};
-
sortedIndexBy([{ x: 4 }, { x: 5 }], { x: 4 }, o => o.x); // 0
-

sortedLastIndex

Returns the highest index at which value should be inserted into array in order to maintain its sort order.

Check if the array is sorted in descending order (loosely). Use Array.reverse() and Array.findIndex() to find the appropriate last index where the element should be inserted.

const sortedLastIndex = (arr, n) => {
-  const isDescending = arr[0] > arr[arr.length - 1];
-  const index = arr.reverse().findIndex(el => (isDescending ? n <= el : n >= el));
-  return index === -1 ? 0 : arr.length - index;
-};
-
sortedLastIndex([10, 20, 30, 30, 40], 30); // 4
-

sortedLastIndexBy

Returns the highest index at which value should be inserted into array in order to maintain its sort order, based on a provided iterator function.

Check if the array is sorted in descending order (loosely). Use Array.map() to apply the iterator function to all elements of the array. Use Array.reverse() and Array.findIndex() to find the appropriate last index where the element should be inserted, based on the provided iterator function.

const sortedLastIndexBy = (arr, n, fn) => {
-  const isDescending = fn(arr[0]) > fn(arr[arr.length - 1]);
-  const val = fn(n);
-  const index = arr
-    .map(fn)
-    .reverse()
-    .findIndex(el => (isDescending ? val <= el : val >= el));
-  return index === -1 ? 0 : arr.length - index;
-};
-
sortedLastIndexBy([{ x: 4 }, { x: 5 }], { x: 4 }, o => o.x); // 1
-

stableSortadvanced

Performs stable sorting of an array, preserving the initial indexes of items when their values are the same. Does not mutate the original array, but returns a new array instead.

Use Array.map() to pair each element of the input array with its corresponding index. Use Array.sort() and a compare function to sort the list, preserving their initial order if the items compared are equal. Use Array.map() to convert back to the initial array items.

const stableSort = (arr, compare) =>
-  arr
-    .map((item, index) => ({ item, index }))
-    .sort((a, b) => compare(a.item, b.item) || a.index - b.index)
-    .map(({ item }) => item);
-
const arr = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
-const stable = stableSort(arr, () => 0); // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
-

symmetricDifference

Returns the symmetric difference between two arrays.

Create a Set from each array, then use Array.filter() on each of them to only keep values not contained in the other.

const symmetricDifference = (a, b) => {
-  const sA = new Set(a),
-    sB = new Set(b);
-  return [...a.filter(x => !sB.has(x)), ...b.filter(x => !sA.has(x))];
-};
-
symmetricDifference([1, 2, 3], [1, 2, 4]); // [3,4]
-

symmetricDifferenceBy

Returns the symmetric difference between two arrays, after applying the provided function to each array element of both.

Create a Set by applying fn to each array's elements, then use Array.filter() on each of them to only keep values not contained in the other.

const symmetricDifferenceBy = (a, b, fn) => {
-  const sA = new Set(a.map(v => fn(v))),
-    sB = new Set(b.map(v => fn(v)));
-  return [...a.filter(x => !sB.has(fn(x))), ...b.filter(x => !sA.has(fn(x)))];
-};
-
symmetricDifferenceBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [ 1.2, 3.4 ]
-

symmetricDifferenceWith

Returns the symmetric difference between two arrays, using a provided function as a comparator.

Use Array.filter() and Array.findIndex() to find the appropriate values.

const symmetricDifferenceWith = (arr, val, comp) => [
-  ...arr.filter(a => val.findIndex(b => comp(a, b)) === -1),
-  ...val.filter(a => arr.findIndex(b => comp(a, b)) === -1)
-];
-
symmetricDifferenceWith(
-  [1, 1.2, 1.5, 3, 0],
-  [1.9, 3, 0, 3.9],
-  (a, b) => Math.round(a) === Math.round(b)
-); // [1, 1.2, 3.9]
-

tail

Returns all elements in an array except for the first one.

Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.

const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
-
tail([1, 2, 3]); // [2,3]
-tail([1]); // [1]
-

take

Returns an array with n elements removed from the beginning.

Use Array.slice() to create a slice of the array with n elements taken from the beginning.

const take = (arr, n = 1) => arr.slice(0, n);
-
take([1, 2, 3], 5); // [1, 2, 3]
-take([1, 2, 3], 0); // []
-

takeRight

Returns an array with n elements removed from the end.

Use Array.slice() to create a slice of the array with n elements taken from the end.

const takeRight = (arr, n = 1) => arr.slice(arr.length - n, arr.length);
-
takeRight([1, 2, 3], 2); // [ 2, 3 ]
-takeRight([1, 2, 3]); // [3]
-

takeRightWhile

Removes elements from the end of an array until the passed function returns true. Returns the removed elements.

Loop through the array, using a for...of loop over Array.keys() until the returned value from the function is true. Return the removed elements, using Array.reverse() and Array.slice().

const takeRightWhile = (arr, func) => {
-  for (let i of arr.reverse().keys())
-    if (func(arr[i])) return arr.reverse().slice(arr.length - i, arr.length);
-  return arr;
-};
-
takeRightWhile([1, 2, 3, 4], n => n < 3); // [3, 4]
-

takeWhile

Removes elements in an array until the passed function returns true. Returns the removed elements.

Loop through the array, using a for...of loop over Array.keys() until the returned value from the function is true. Return the removed elements, using Array.slice().

const takeWhile = (arr, func) => {
-  for (let i of arr.keys()) if (func(arr[i])) return arr.slice(0, i);
-  return arr;
-};
-
takeWhile([1, 2, 3, 4], n => n >= 3); // [1, 2]
-

union

Returns every element that exists in any of the two arrays once.

Create a Set with all values of a and b and convert to an array.

const union = (a, b) => Array.from(new Set([...a, ...b]));
-
union([1, 2, 3], [4, 3, 2]); // [1,2,3,4]
-

unionBy

Returns every element that exists in any of the two arrays once, after applying the provided function to each array element of both.

Create a Set by applying all fn to all values of a. Create a Set from a and all elements in b whose value, after applying fn does not match a value in the previously created set. Return the last set converted to an array.

const unionBy = (a, b, fn) => {
-  const s = new Set(a.map(v => fn(v)));
-  return Array.from(new Set([...a, ...b.filter(x => !s.has(fn(x)))]));
-};
-
unionBy([2.1], [1.2, 2.3], Math.floor); // [2.1, 1.2]
-

unionWith

Returns every element that exists in any of the two arrays once, using a provided comparator function.

Create a Set with all values of a and values in b for which the comparator finds no matches in a, using Array.findIndex().

const unionWith = (a, b, comp) =>
-  Array.from(new Set([...a, ...b.filter(x => a.findIndex(y => comp(x, y)) === -1)]));
-
unionWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0, 3.9], (a, b) => Math.round(a) === Math.round(b)); // [1, 1.2, 1.5, 3, 0, 3.9]
-

uniqueElements

Returns all unique values of an array.

Use ES6 Set and the ...rest operator to discard all duplicated values.

const uniqueElements = arr => [...new Set(arr)];
-
uniqueElements([1, 2, 2, 3, 4, 4, 5]); // [1,2,3,4,5]
-

unzip

Creates an array of arrays, ungrouping the elements in an array produced by zip.

Use Math.max.apply() to get the longest subarray in the array, Array.map() to make each element an array. Use Array.reduce() and Array.forEach() to map grouped values to individual arrays.

const unzip = arr =>
-  arr.reduce(
-    (acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
-    Array.from({
-      length: Math.max(...arr.map(x => x.length))
-    }).map(x => [])
-  );
-
unzip([['a', 1, true], ['b', 2, false]]); //[['a', 'b'], [1, 2], [true, false]]
-unzip([['a', 1, true], ['b', 2]]); //[['a', 'b'], [1, 2], [true]]
-

unzipWithadvanced

Creates an array of elements, ungrouping the elements in an array produced by zip and applying the provided function.

Use Math.max.apply() to get the longest subarray in the array, Array.map() to make each element an array. Use Array.reduce() and Array.forEach() to map grouped values to individual arrays. Use Array.map() and the spread operator (...) to apply fn to each individual group of elements.

const unzipWith = (arr, fn) =>
-  arr
-    .reduce(
-      (acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
-      Array.from({
-        length: Math.max(...arr.map(x => x.length))
-      }).map(x => [])
-    )
-    .map(val => fn(...val));
-
unzipWith([[1, 10, 100], [2, 20, 200]], (...args) => args.reduce((acc, v) => acc + v, 0)); // [3, 30, 300]
-

without

Filters out the elements of an array, that have one of the specified values.

Use Array.filter() to create an array excluding(using !Array.includes()) all given values.

(For a snippet that mutates the original array see pull)

const without = (arr, ...args) => arr.filter(v => !args.includes(v));
-
without([2, 1, 2, 3], 1, 2); // [3]
-

xProd

Creates a new array out of the two supplied by creating each possible pair from the arrays.

Use Array.reduce(), Array.map() and Array.concat() to produce every possible pair from the elements of the two arrays and save them in an array.

const xProd = (a, b) => a.reduce((acc, x) => acc.concat(b.map(y => [x, y])), []);
-
xProd([1, 2], ['a', 'b']); // [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
-

zip

Creates an array of elements, grouped based on the position in the original arrays.

Use Math.max.apply() to get the longest array in the arguments. Creates an array with that length as return value and use Array.from() with a map-function to create an array of grouped elements. If lengths of the argument-arrays vary, undefined is used where no value could be found.

const zip = (...arrays) => {
-  const maxLength = Math.max(...arrays.map(x => x.length));
-  return Array.from({ length: maxLength }).map((_, i) => {
-    return Array.from({ length: arrays.length }, (_, k) => arrays[k][i]);
-  });
-};
-
zip(['a', 'b'], [1, 2], [true, false]); // [['a', 1, true], ['b', 2, false]]
-zip(['a'], [1, 2], [true, false]); // [['a', 1, true], [undefined, 2, false]]
-

zipObject

Given an array of valid property identifiers and an array of values, return an object associating the properties to the values.

Since an object can have undefined values but not undefined property pointers, the array of properties is used to decide the structure of the resulting object using Array.reduce().

const zipObject = (props, values) =>
-  props.reduce((obj, prop, index) => ((obj[prop] = values[index]), obj), {});
-
zipObject(['a', 'b', 'c'], [1, 2]); // {a: 1, b: 2, c: undefined}
-zipObject(['a', 'b'], [1, 2, 3]); // {a: 1, b: 2}
-

zipWithadvanced

Creates an array of elements, grouped based on the position in the original arrays and using function as the last value to specify how grouped values should be combined.

Check if the last argument provided is a function. Use Math.max() to get the longest array in the arguments. Creates an array with that length as return value and use Array.from() with a map-function to create an array of grouped elements. If lengths of the argument-arrays vary, undefined is used where no value could be found. The function is invoked with the elements of each group (...group).

const zipWith = (...array) => {
-  const fn = typeof array[array.length - 1] === 'function' ? array.pop() : undefined;
-  return Array.from(
-    { length: Math.max(...array.map(a => a.length)) },
-    (_, i) => (fn ? fn(...array.map(a => a[i])) : array.map(a => a[i]))
-  );
-};
-
zipWith([1, 2], [10, 20], [100, 200], (a, b, c) => a + b + c); // [111,222]
-zipWith(
-  [1, 2, 3],
-  [10, 20],
-  [100, 200],
-  (a, b, c) => (a != null ? a : 'a') + (b != null ? b : 'b') + (c != null ? c : 'c')
-); // [111, 222, '3bc']
-

Browser

arrayToHtmlList

Converts the given array elements into <li> tags and appends them to the list of the given id.

Use Array.map() and document.querySelector() to create a list of html tags.

const arrayToHtmlList = (arr, listID) =>
-  arr.map(item => (document.querySelector('#' + listID).innerHTML += `<li>${item}</li>`));
-
arrayToHtmlList(['item 1', 'item 2'], 'myListID');
-

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
-  document.documentElement.clientHeight + window.scrollY >=
-  (document.documentElement.scrollHeight || document.documentElement.clientHeight);
-
bottomVisible(); // true
-

copyToClipboardadvanced

Copy a string to the clipboard. Only works as a result of user action (i.e. inside a click event listener).

Create a new <textarea> element, fill it with the supplied data and add it to the HTML document. Use Selection.getRangeAt()to store the selected range (if any). Use document.execCommand('copy') to copy to the clipboard. Remove the <textarea> element from the HTML document. Finally, use Selection().addRange() to recover the original selected range (if any).

const copyToClipboard = str => {
-  const el = document.createElement('textarea');
-  el.value = str;
-  el.setAttribute('readonly', '');
-  el.style.position = 'absolute';
-  el.style.left = '-9999px';
-  document.body.appendChild(el);
-  const selected =
-    document.getSelection().rangeCount > 0 ? document.getSelection().getRangeAt(0) : false;
-  el.select();
-  document.execCommand('copy');
-  document.body.removeChild(el);
-  if (selected) {
-    document.getSelection().removeAllRanges();
-    document.getSelection().addRange(selected);
-  }
-};
-
copyToClipboard('Lorem ipsum'); // 'Lorem ipsum' copied to clipboard.
-

createElement

Creates an element from a string (without appending it to the document). If the given string contains multiple elements, only the first one will be returned.

Use document.createElement() to create a new element. Set its innerHTML to the string supplied as the argument. Use ParentNode.firstElementChild to return the element version of the string.

const createElement = str => {
-  const el = document.createElement('div');
-  el.innerHTML = str;
-  return el.firstElementChild;
-};
-
const el = createElement(
-  `<div class="container">
-    <p>Hello!</p>
-  </div>`
-);
-console.log(el.className); // 'container'
-

createEventHubadvanced

Creates a pub/sub (publish–subscribe) event hub with emit, on, and off methods.

Use Object.create(null) to create an empty hub object that does not inherit properties from Object.prototype. For emit, resolve the array of handlers based on the event argument and then run each one with Array.forEach() by passing in the data as an argument. For on, create an array for the event if it does not yet exist, then use Array.push() to add the handler to the array. For off, use Array.findIndex() to find the index of the handler in the event array and remove it using Array.splice().

const createEventHub = () => ({
-  hub: Object.create(null),
-  emit(event, data) {
-    (this.hub[event] || []).forEach(handler => handler(data));
-  },
-  on(event, handler) {
-    if (!this.hub[event]) this.hub[event] = [];
-    this.hub[event].push(handler);
-  },
-  off(event, handler) {
-    const i = (this.hub[event] || []).findIndex(h => h === handler);
-    if (i > -1) this.hub[event].splice(i, 1);
-  }
-});
-
const handler = data => console.log(data);
-const hub = createEventHub();
-let increment = 0;
-
-// Subscribe: listen for different types of events
-hub.on('message', handler);
-hub.on('message', () => console.log('Message event fired'));
-hub.on('increment', () => increment++);
-
-// Publish: emit events to invoke all handlers subscribed to them, passing the data to them as an argument
-hub.emit('message', 'hello world'); // logs 'hello world' and 'Message event fired'
-hub.emit('message', { hello: 'world' }); // logs the object and 'Message event fired'
-hub.emit('increment'); // `increment` variable is now 1
-
-// Unsubscribe: stop a specific handler from listening to the 'message' event
-hub.off('message', handler);
-

currentURL

Returns the current URL.

Use window.location.href to get current URL.

const currentURL = () => window.location.href;
-
currentURL(); // 'https://google.com'
-

detectDeviceType

Detects wether the website is being opened in a mobile device or a desktop/laptop.

Use a regular expression to test the navigator.userAgent property to figure out if the device is a mobile device or a desktop/laptop.

const detectDeviceType = () =>
-  /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent)
-    ? 'Mobile'
-    : 'Desktop';
-
detectDeviceType(); // "Mobile" or "Desktop"
-

elementIsVisibleInViewport

Returns true if the element specified is visible in the viewport, false otherwise.

Use Element.getBoundingClientRect() and the window.inner(Width|Height) values to determine if a given element is visible in the viewport. Omit the second argument to determine if the element is entirely visible, or specify true to determine if it is partially visible.

const elementIsVisibleInViewport = (el, partiallyVisible = false) => {
-  const { top, left, bottom, right } = el.getBoundingClientRect();
-  const { innerHeight, innerWidth } = window;
-  return partiallyVisible
-    ? ((top > 0 && top < innerHeight) || (bottom > 0 && bottom < innerHeight)) &&
-        ((left > 0 && left < innerWidth) || (right > 0 && right < innerWidth))
-    : top >= 0 && left >= 0 && bottom <= innerHeight && right <= innerWidth;
-};
-
// e.g. 100x100 viewport and a 10x10px element at position {top: -1, left: 0, bottom: 9, right: 10}
-elementIsVisibleInViewport(el); // false - (not fully visible)
-elementIsVisibleInViewport(el, true); // true - (partially visible)
-

getScrollPosition

Returns the scroll position of the current page.

Use pageXOffset and pageYOffset if they are defined, otherwise scrollLeft and scrollTop. You can omit el to use a default value of window.

const getScrollPosition = (el = window) => ({
-  x: el.pageXOffset !== undefined ? el.pageXOffset : el.scrollLeft,
-  y: el.pageYOffset !== undefined ? el.pageYOffset : el.scrollTop
-});
-
getScrollPosition(); // {x: 0, y: 200}
-

getStyle

Returns the value of a CSS rule for the specified element.

Use Window.getComputedStyle() to get the value of the CSS rule for the specified element.

const getStyle = (el, ruleName) => getComputedStyle(el)[ruleName];
-
getStyle(document.querySelector('p'), 'font-size'); // '16px'
-

hasClass

Returns true if the element has the specified class, false otherwise.

Use element.classList.contains() to check if the element has the specified class.

const hasClass = (el, className) => el.classList.contains(className);
-
hasClass(document.querySelector('p.special'), 'special'); // true
-

hashBrowseradvanced

Creates a hash for a value using the SHA-256 algorithm. Returns a promise.

Use the SubtleCrypto API to create a hash for the given value.

const hashBrowser = val =>
-  crypto.subtle.digest('SHA-256', new TextEncoder('utf-8').encode(val)).then(h => {
-    let hexes = [],
-      view = new DataView(h);
-    for (let i = 0; i < view.byteLength; i += 4)
-      hexes.push(('00000000' + view.getUint32(i).toString(16)).slice(-8));
-    return hexes.join('');
-  });
-
hashBrowser(JSON.stringify({ a: 'a', b: [1, 2, 3, 4], foo: { c: 'bar' } })).then(console.log); // '04aa106279f5977f59f9067fa9712afc4aedc6f5862a8defc34552d8c7206393'
-

hide

Hides all the elements specified.

Use the spread operator (...) and Array.forEach() to apply display: none to each element specified.

const hide = (...el) => [...el].forEach(e => (e.style.display = 'none'));
-
hide(...document.querySelectorAll('img')); // Hides all <img> elements on the page
-

httpsRedirect

Redirects the page to HTTPS if its currently in HTTP. Also, pressing the back button doesn't take it back to the HTTP page as its replaced in the history.

Use location.protocol to get the protocol currently being used. If it's not HTTPS, use location.replace() to replace the existing page with the HTTPS version of the page. Use location.href to get the full address, split it with String.split() and remove the protocol part of the URL.

const httpsRedirect = () => {
-  if (location.protocol !== 'https:') location.replace('https://' + location.href.split('//')[1]);
-};
-
httpsRedirect(); // If you are on http://mydomain.com, you are redirected to https://mydomain.com
-

observeMutationsadvanced

Returns a new MutationObserver and runs the provided callback for each mutation on the specified element.

Use a MutationObserver to observe mutations on the given element. Use Array.forEach() to run the callback for each mutation that is observed. Omit the third argument, options, to use the default options (all true).

const observeMutations = (element, callback, options) => {
-  const observer = new MutationObserver(mutations => mutations.forEach(m => callback(m)));
-  observer.observe(
-    element,
-    Object.assign(
-      {
-        childList: true,
-        attributes: true,
-        attributeOldValue: true,
-        characterData: true,
-        characterDataOldValue: true,
-        subtree: true
-      },
-      options
-    )
-  );
-  return observer;
-};
-
const obs = observeMutations(document, console.log); // Logs all mutations that happen on the page
-obs.disconnect(); // Disconnects the observer and stops logging mutations on the page
-

off

Removes an event listener from an element.

Use EventTarget.removeEventListener() to remove an event listener from an element. Omit the fourth argument opts to use false or specify it based on the options used when the event listener was added.

const off = (el, evt, fn, opts = false) => el.removeEventListener(evt, fn, opts);
-
const fn = () => console.log('!');
-document.body.addEventListener('click', fn);
-off(document.body, 'click', fn); // no longer logs '!' upon clicking on the page
-

on

Adds an event listener to an element with the ability to use event delegation.

Use EventTarget.addEventListener() to add an event listener to an element. If there is a target property supplied to the options object, ensure the event target matches the target specified and then invoke the callback by supplying the correct this context. Returns a reference to the custom delegator function, in order to be possible to use with off. Omit opts to default to non-delegation behavior and event bubbling.

const on = (el, evt, fn, opts = {}) => {
-  const delegatorFn = e => e.target.matches(opts.target) && fn.call(e.target, e);
-  el.addEventListener(evt, opts.target ? delegatorFn : fn, opts.options || false);
-  if (opts.target) return delegatorFn;
-};
-
const fn = () => console.log('!');
-on(document.body, 'click', fn); // logs '!' upon clicking the body
-on(document.body, 'click', fn, { target: 'p' }); // logs '!' upon clicking a `p` element child of the body
-on(document.body, 'click', fn, { options: true }); // use capturing instead of bubbling
-

onUserInputChangeadvanced

Run the callback whenever the user input type changes (mouse or touch). Useful for enabling/disabling code depending on the input device. This process is dynamic and works with hybrid devices (e.g. touchscreen laptops).

Use two event listeners. Assume mouse input initially and bind a touchstart event listener to the document. On touchstart, add a mousemove event listener to listen for two consecutive mousemove events firing within 20ms, using performance.now(). Run the callback with the input type as an argument in either of these situations.

const onUserInputChange = callback => {
-  let type = 'mouse',
-    lastTime = 0;
-  const mousemoveHandler = () => {
-    const now = performance.now();
-    if (now - lastTime < 20)
-      (type = 'mouse'), callback(type), document.removeEventListener('mousemove', mousemoveHandler);
-    lastTime = now;
-  };
-  document.addEventListener('touchstart', () => {
-    if (type === 'touch') return;
-    (type = 'touch'), callback(type), document.addEventListener('mousemove', mousemoveHandler);
-  });
-};
-
onUserInputChange(type => {
-  console.log('The user is now using', type, 'as an input method.');
-});
-

prefix

Returns the prefixed version (if necessary) of a CSS property that the browser supports.

Use Array.findIndex() on an array of vendor prefix strings to test if document.body has one of them defined in its CSSStyleDeclaration object, otherwise return null. Use String.charAt() and String.toUpperCase() to capitalize the property, which will be appended to the vendor prefix string.

const prefix = prop => {
-  const capitalizedProp = prop.charAt(0).toUpperCase() + prop.slice(1);
-  const prefixes = ['', 'webkit', 'moz', 'ms', 'o'];
-  const i = prefixes.findIndex(
-    prefix => typeof document.body.style[prefix ? prefix + capitalizedProp : prop] !== 'undefined'
-  );
-  return i !== -1 ? (i === 0 ? prop : prefixes[i] + capitalizedProp) : null;
-};
-
prefix('appearance'); // 'appearance' on a supported browser, otherwise 'webkitAppearance', 'mozAppearance', 'msAppearance' or 'oAppearance'
-

recordAnimationFrames

Invokes the provided callback on each animation frame.

Use recursion. Provided that running is true, continue invoking window.requestAnimationFrame() which invokes the provided callback. Return an object with two methods start and stop to allow manual control of the recording. Omit the second argument, autoStart, to implicitly call start when the function is invoked.

const recordAnimationFrames = (callback, autoStart = true) => {
-  let running = true,
-    raf;
-  const stop = () => {
-    running = false;
-    cancelAnimationFrame(raf);
-  };
-  const start = () => {
-    running = true;
-    run();
-  };
-  const run = () => {
-    raf = requestAnimationFrame(() => {
-      callback();
-      if (running) run();
-    });
-  };
-  if (autoStart) start();
-  return { start, stop };
-};
-
const cb = () => console.log('Animation frame fired');
-const recorder = recordAnimationFrames(cb); // logs 'Animation frame fired' on each animation frame
-recorder.stop(); // stops logging
-recorder.start(); // starts again
-const recorder2 = recordAnimationFrames(cb, false); // `start` needs to be explicitly called to begin recording frames
-

redirect

Redirects to a specified URL.

Use window.location.href or window.location.replace() to redirect to url. Pass a second argument to simulate a link click (true - default) or an HTTP redirect (false).

const redirect = (url, asLink = true) =>
-  asLink ? (window.location.href = url) : window.location.replace(url);
-
redirect('https://google.com');
-

runAsyncadvanced

Runs a function in a separate thread by using a Web Worker, allowing long running functions to not block the UI.

Create a new Worker using a Blob object URL, the contents of which should be the stringified version of the supplied function. Immediately post the return value of calling the function back. Return a promise, listening for onmessage and onerror events and resolving the data posted back from the worker, or throwing an error.

const runAsync = fn => {
-  const worker = new Worker(
-    URL.createObjectURL(new Blob([`postMessage((${fn})());`]), {
-      type: 'application/javascript; charset=utf-8'
-    })
-  );
-  return new Promise((res, rej) => {
-    worker.onmessage = ({ data }) => {
-      res(data), worker.terminate();
-    };
-    worker.onerror = err => {
-      rej(err), worker.terminate();
-    };
-  });
-};
-
const longRunningFunction = () => {
-  let result = 0;
-  for (let i = 0; i < 1000; i++) {
-    for (let j = 0; j < 700; j++) {
-      for (let k = 0; k < 300; k++) {
-        result = result + i + j + k;
-      }
-    }
-  }
-  return result;
-};
-/*
-  NOTE: Since the function is running in a different context, closures are not supported.
-  The function supplied to `runAsync` gets stringified, so everything becomes literal.
-  All variables and functions must be defined inside.
-*/
-runAsync(longRunningFunction).then(console.log); // 209685000000
-runAsync(() => 10 ** 3).then(console.log); // 1000
-let outsideVariable = 50;
-runAsync(() => typeof outsideVariable).then(console.log); // 'undefined'
-

scrollToTop

Smooth-scrolls to the top of the page.

Get distance from top using document.documentElement.scrollTop or document.body.scrollTop. Scroll by a fraction of the distance from the top. Use window.requestAnimationFrame() to animate the scrolling.

const scrollToTop = () => {
-  const c = document.documentElement.scrollTop || document.body.scrollTop;
-  if (c > 0) {
-    window.requestAnimationFrame(scrollToTop);
-    window.scrollTo(0, c - c / 8);
-  }
-};
-
scrollToTop();
-

setStyle

Sets the value of a CSS rule for the specified element.

Use element.style to set the value of the CSS rule for the specified element to val.

const setStyle = (el, ruleName, val) => (el.style[ruleName] = val);
-
setStyle(document.querySelector('p'), 'font-size', '20px'); // The first <p> element on the page will have a font-size of 20px
-

show

Shows all the elements specified.

Use the spread operator (...) and Array.forEach() to clear the display property for each element specified.

const show = (...el) => [...el].forEach(e => (e.style.display = ''));
-
show(...document.querySelectorAll('img')); // Shows all <img> elements on the page
-

smoothScroll

Smoothly scrolls the element on which it's called into the visible area of the browser window.

Use .scrollIntoView method to scroll the element. Pass { behavior: 'smooth' } to .scrollIntoView so it scrolls smoothly.

const smoothScroll = element =>
-  document.querySelector(element).scrollIntoView({
-    behavior: 'smooth'
-  });
-
smoothScroll('#fooBar'); // scrolls smoothly to the element with the id fooBar
-smoothScroll('.fooBar'); // scrolls smoothly to the first element with a class of fooBar
-

toggleClass

Toggle a class for an element.

Use element.classList.toggle() to toggle the specified class for the element.

const toggleClass = (el, className) => el.classList.toggle(className);
-
toggleClass(document.querySelector('p.special'), 'special'); // The paragraph will not have the 'special' class anymore
-

UUIDGeneratorBrowser

Generates a UUID in a browser.

Use crypto API to generate a UUID, compliant with RFC4122 version 4.

const UUIDGeneratorBrowser = () =>
-  ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c =>
-    (c ^ (crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (c / 4)))).toString(16)
-  );
-
UUIDGeneratorBrowser(); // '7982fcfe-5721-4632-bede-6000885be57d'
-

Date

formatDuration

Returns the human readable format of the given number of milliseconds.

Divide ms with the appropriate values to obtain the appropriate values for day, hour, minute, second and millisecond. Use Object.entries() with Array.filter() to keep only non-zero values. Use Array.map() to create the string for each value, pluralizing appropriately. Use String.join(', ') to combine the values into a string.

const formatDuration = ms => {
-  if (ms < 0) ms = -ms;
-  const time = {
-    day: Math.floor(ms / 86400000),
-    hour: Math.floor(ms / 3600000) % 24,
-    minute: Math.floor(ms / 60000) % 60,
-    second: Math.floor(ms / 1000) % 60,
-    millisecond: Math.floor(ms) % 1000
-  };
-  return Object.entries(time)
-    .filter(val => val[1] !== 0)
-    .map(val => val[1] + ' ' + (val[1] !== 1 ? val[0] + 's' : val[0]))
-    .join(', ');
-};
-
formatDuration(1001); // '1 second, 1 millisecond'
-formatDuration(34325055574); // '397 days, 6 hours, 44 minutes, 15 seconds, 574 milliseconds'
-

getColonTimeFromDate

Returns a string of the form HH:MM:SS from a Date object.

Use Date.toString() and String.slice() to get the HH:MM:SS part of a given Date object.

const getColonTimeFromDate = date => date.toTimeString().slice(0, 8);
-
getColonTimeFromDate(new Date()); // "08:38:00"
-

getDaysDiffBetweenDates

Returns the difference (in days) between two dates.

Calculate the difference (in days) between two Date objects.

const getDaysDiffBetweenDates = (dateInitial, dateFinal) =>
-  (dateFinal - dateInitial) / (1000 * 3600 * 24);
-
getDaysDiffBetweenDates(new Date('2017-12-13'), new Date('2017-12-22')); // 9
-

getMeridiemSuffixOfInteger

Converts an integer to a suffixed string, adding am or pm based on its value.

Use the modulo operator (%) and conditional checks to transform an integer to a stringified 12-hour format with meridiem suffix.

const getMeridiemSuffixOfInteger = num =>
-  num === 0 || num === 24
-    ? 12 + 'am'
-    : num === 12 ? 12 + 'pm' : num < 12 ? num % 12 + 'am' : num % 12 + 'pm';
-
getMeridiemSuffixOfInteger(0); // "12am"
-getMeridiemSuffixOfInteger(11); // "11am"
-getMeridiemSuffixOfInteger(13); // "1pm"
-getMeridiemSuffixOfInteger(25); // "1pm"
-

tomorrow

Results in a string representation of tomorrow's date. Use new Date() to get today's date, adding one day using Date.getDate() and Date.setDate(), and converting the Date object to a string.

const tomorrow = (long = false) => {
-  let t = new Date();
-  t.setDate(t.getDate() + 1);
-  const ret = `${t.getFullYear()}-${String(t.getMonth() + 1).padStart(2, '0')}-${String(
-    t.getDate()
-  ).padStart(2, '0')}`;
-  return !long ? ret : `${ret}T00:00:00`;
-};
-
tomorrow(); // 2017-12-27 (if current date is 2017-12-26)
-tomorrow(true); // 2017-12-27T00:00:00 (if current date is 2017-12-26)
-

Function

attempt

Attempts to invoke a function with the provided arguments, returning either the result or the caught error object.

Use a try... catch block to return either the result of the function or an appropriate error.

const attempt = (fn, ...args) => {
-  try {
-    return fn(...args);
-  } catch (e) {
-    return e instanceof Error ? e : new Error(e);
-  }
-};
-
var elements = attempt(function(selector) {
-  return document.querySelectorAll(selector);
-}, '>_>');
-if (elements instanceof Error) elements = []; // elements = []
-

bind

Creates a function that invokes fn with a given context, optionally adding any additional supplied parameters to the beginning of the arguments.

Return a function that uses Function.apply() to apply the given context to fn. Use Array.concat() to prepend any additional supplied parameters to the arguments.

const bind = (fn, context, ...args) =>
-  function() {
-    return fn.apply(context, args.concat(...arguments));
-  };
-
function greet(greeting, punctuation) {
-  return greeting + ' ' + this.user + punctuation;
-}
-const freddy = { user: 'fred' };
-const freddyBound = bind(greet, freddy);
-console.log(freddyBound('hi', '!')); // 'hi fred!'
-

bindKey

Creates a function that invokes the method at a given key of an object, optionally adding any additional supplied parameters to the beginning of the arguments.

Return a function that uses Function.apply() to bind context[fn] to context. Use Array.concat() to prepend any additional supplied parameters to the arguments.

const bindKey = (context, fn, ...args) =>
-  function() {
-    return context[fn].apply(context, args.concat(...arguments));
-  };
-
const freddy = {
-  user: 'fred',
-  greet: function(greeting, punctuation) {
-    return greeting + ' ' + this.user + punctuation;
-  }
-};
-const freddyBound = bindKey(freddy, 'greet');
-console.log(freddyBound('hi', '!')); // 'hi fred!'
-

chainAsync

Chains asynchronous functions.

Loop through an array of functions containing asynchronous events, calling next when each asynchronous event has completed.

const chainAsync = fns => {
-  let curr = 0;
-  const next = () => fns[curr++](next);
-  next();
-};
-
chainAsync([
-  next => {
-    console.log('0 seconds');
-    setTimeout(next, 1000);
-  },
-  next => {
-    console.log('1 second');
-  }
-]);
-

compose

Performs right-to-left function composition.

Use Array.reduce() to perform right-to-left function composition. The last (rightmost) function can accept one or more arguments; the remaining functions must be unary.

const compose = (...fns) => fns.reduce((f, g) => (...args) => f(g(...args)));
-
const add5 = x => x + 5;
-const multiply = (x, y) => x * y;
-const multiplyAndAdd5 = compose(add5, multiply);
-multiplyAndAdd5(5, 2); // 15
-

composeRight

Performs left-to-right function composition.

Use Array.reduce() to perform left-to-right function composition. The first (leftmost) function can accept one or more arguments; the remaining functions must be unary.

const composeRight = (...fns) => fns.reduce((f, g) => (...args) => g(f(...args)));
-
const add = (x, y) => x + y;
-const square = x => x * x;
-const addAndSquare = composeRight(add, square);
-addAndSquare(1, 2); // 9
-

converge

Accepts a converging function and a list of branching functions and returns a function that applies each branching function to the arguments and the results of the branching functions are passed as arguments to the converging function.

Use Array.map() and Function.apply() to apply each function to the given arguments. Use the spread operator (...) to call coverger with the results of all other functions.

const converge = (converger, fns) => (...args) => converger(...fns.map(fn => fn.apply(null, args)));
-
const average = converge((a, b) => a / b, [
-  arr => arr.reduce((a, v) => a + v, 0),
-  arr => arr.length
-]);
-average([1, 2, 3, 4, 5, 6, 7]); // 4
-

curry

Curries a function.

Use recursion. If the number of provided arguments (args) is sufficient, call the passed function fn. Otherwise, return a curried function fn that expects the rest of the arguments. If you want to curry a function that accepts a variable number of arguments (a variadic function, e.g. Math.min()), you can optionally pass the number of arguments to the second parameter arity.

const curry = (fn, arity = fn.length, ...args) =>
-  arity <= args.length ? fn(...args) : curry.bind(null, fn, arity, ...args);
-
curry(Math.pow)(2)(10); // 1024
-curry(Math.min, 3)(10)(50)(2); // 2
-

debounce

Creates a debounced function that delays invoking the provided function until at least ms milliseconds have elapsed since the last time it was invoked.

Each time the debounced function is invoked, clear the current pending timeout with clearTimeout() and use setTimeout() to create a new timeout that delays invoking the function until at least ms milliseconds has elapsed. Use Function.apply() to apply the this context to the function and provide the necessary arguments. Omit the second argument, ms, to set the timeout at a default of 0 ms.

const debounce = (fn, ms = 0) => {
-  let timeoutId;
-  return function(...args) {
-    clearTimeout(timeoutId);
-    timeoutId = setTimeout(() => fn.apply(this, args), ms);
-  };
-};
-
window.addEventListener(
-  'resize',
-  debounce(() => {
-    console.log(window.innerWidth);
-    console.log(window.innerHeight);
-  }, 250)
-); // Will log the window dimensions at most every 250ms
-

defer

Defers invoking a function until the current call stack has cleared.

Use setTimeout() with a timeout of 1ms to add a new event to the browser event queue and allow the rendering engine to complete its work. Use the spread (...) operator to supply the function with an arbitrary number of arguments.

const defer = (fn, ...args) => setTimeout(fn, 1, ...args);
-
// Example A:
-defer(console.log, 'a'), console.log('b'); // logs 'b' then 'a'
-
-// Example B:
-document.querySelector('#someElement').innerHTML = 'Hello';
-longRunningFunction(); //Browser will not update the HTML until this has finished
-defer(longRunningFunction); // Browser will update the HTML then run the function
-

delay

Invokes the provided function after wait milliseconds.

Use setTimeout() to delay execution of fn. Use the spread (...) operator to supply the function with an arbitrary number of arguments.

const delay = (fn, wait, ...args) => setTimeout(fn, wait, ...args);
-
delay(
-  function(text) {
-    console.log(text);
-  },
-  1000,
-  'later'
-); // Logs 'later' after one second.
-

functionName

Logs the name of a function.

Use console.debug() and the name property of the passed method to log the method's name to the debug channel of the console.

const functionName = fn => (console.debug(fn.name), fn);
-
functionName(Math.max); // max (logged in debug channel of console)
-

memoize

Returns the memoized (cached) function.

Create an empty cache by instantiating a new Map object. Return a function which takes a single argument to be supplied to the memoized function by first checking if the function's output for that specific input value is already cached, or store and return it if not. The function keyword must be used in order to allow the memoized function to have its this context changed if necessary. Allow access to the cache by setting it as a property on the returned function.

const memoize = fn => {
-  const cache = new Map();
-  const cached = function(val) {
-    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val);
-  };
-  cached.cache = cache;
-  return cached;
-};
-
// See the `anagrams` snippet.
-const anagramsCached = memoize(anagrams);
-anagramsCached('javascript'); // takes a long time
-anagramsCached('javascript'); // returns virtually instantly since it's now cached
-console.log(anagramsCached.cache); // The cached anagrams map
-

negate

Negates a predicate function.

Take a predicate function and apply the not operator (!) to it with its arguments.

const negate = func => (...args) => !func(...args);
-
[1, 2, 3, 4, 5, 6].filter(negate(n => n % 2 === 0)); // [ 1, 3, 5 ]
-

once

Ensures a function is called only once.

Utilizing a closure, use a flag, called, and set it to true once the function is called for the first time, preventing it from being called again. In order to allow the function to have its this context changed (such as in an event listener), the function keyword must be used, and the supplied function must have the context applied. Allow the function to be supplied with an arbitrary number of arguments using the rest/spread (...) operator.

const once = fn => {
-  let called = false;
-  return function(...args) {
-    if (called) return;
-    called = true;
-    return fn.apply(this, args);
-  };
-};
-
const startApp = function(event) {
-  console.log(this, event); // document.body, MouseEvent
-};
-document.body.addEventListener('click', once(startApp)); // only runs `startApp` once upon click
-

partial

Creates a function that invokes fn with partials prepended to the arguments it receives.

Use the spread operator (...) to prepend partials to the list of arguments of fn.

const partial = (fn, ...partials) => (...args) => fn(...partials, ...args);
-
const greet = (greeting, name) => greeting + ' ' + name + '!';
-const greetHello = partial(greet, 'Hello');
-greetHello('John'); // 'Hello John!'
-

partialRight

Creates a function that invokes fn with partials appended to the arguments it receives.

Use the spread operator (...) to append partials to the list of arguments of fn.

const partialRight = (fn, ...partials) => (...args) => fn(...args, ...partials);
-
const greet = (greeting, name) => greeting + ' ' + name + '!';
-const greetJohn = partialRight(greet, 'John');
-greetJohn('Hello'); // 'Hello John!'
-

runPromisesInSeries

Runs an array of promises in series.

Use Array.reduce() to create a promise chain, where each promise returns the next promise when resolved.

const runPromisesInSeries = ps => ps.reduce((p, next) => p.then(next), Promise.resolve());
-
const delay = d => new Promise(r => setTimeout(r, d));
-runPromisesInSeries([() => delay(1000), () => delay(2000)]); // Executes each promise sequentially, taking a total of 3 seconds to complete
-

sleep

Delays the execution of an asynchronous function.

Delay executing part of an async function, by putting it to sleep, returning a Promise.

const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
-
async function sleepyWork() {
-  console.log("I'm going to sleep for 1 second.");
-  await sleep(1000);
-  console.log('I woke up after 1 second.');
-}
-

throttle

Creates a throttled function that only invokes the provided function at most once per every wait milliseconds

Use setTimeout() and clearTimeout() to throttle the given method, fn. Use Function.apply() to apply the this context to the function and provide the necessary arguments. Use Date.now() to keep track of the last time the throttled function was invoked. Omit the second argument, wait, to set the timeout at a default of 0 ms.

const throttle = (fn, wait) => {
-  let inThrottle, lastFn, lastTime;
-  return function() {
-    const context = this,
-      args = arguments;
-    if (!inThrottle) {
-      fn.apply(context, args);
-      lastTime = Date.now();
-      inThrottle = true;
-    } else {
-      clearTimeout(lastFn);
-      lastFn = setTimeout(function() {
-        if (Date.now() - lastTime >= wait) {
-          fn.apply(context, args);
-          lastTime = Date.now();
-        }
-      }, wait - (Date.now() - lastTime));
-    }
-  };
-};
-
window.addEventListener(
-  'resize',
-  throttle(function(evt) {
-    console.log(window.innerWidth);
-    console.log(window.innerHeight);
-  }, 250)
-); // Will log the window dimensions at most every 250ms
-

times

Iterates over a callback n times

Use Function.call() to call fn n times or until it returns false. Omit the last argument, context, to use an undefined object (or the global object in non-strict mode).

const times = (n, fn, context = undefined) => {
-  let i = 0;
-  while (fn.call(context, i) !== false && ++i < n) {}
-};
-
var output = '';
-times(5, i => (output += i));
-console.log(output); // 01234
-

uncurry

Uncurries a function up to depth n.

Return a variadic function. Use Array.reduce() on the provided arguments to call each subsequent curry level of the function. If the length of the provided arguments is less than n throw an error. Otherwise, call fn with the proper amount of arguments, using Array.slice(0, n). Omit the second argument, n, to uncurry up to depth 1.

const uncurry = (fn, n = 1) => (...args) => {
-  const next = acc => args => args.reduce((x, y) => x(y), acc);
-  if (n > args.length) throw new RangeError('Arguments too few!');
-  return next(fn)(args.slice(0, n));
-};
-
const add = x => y => z => x + y + z;
-const uncurriedAdd = uncurry(add, 3);
-uncurriedAdd(1, 2, 3); // 6
-

unfold

Builds an array, using an iterator function and an initial seed value.

Use a while loop and Array.push() to call the function repeatedly until it returns false. The iterator function accepts one argument (seed) and must always return an array with two elements ([value, nextSeed]) or false to terminate.

const unfold = (fn, seed) => {
-  let result = [],
-    val = [null, seed];
-  while ((val = fn(val[1]))) result.push(val[0]);
-  return result;
-};
-
var f = n => (n > 50 ? false : [-n, n + 10]);
-unfold(f, 10); // [-10, -20, -30, -40, -50]
-

Math

approximatelyEqual

Checks if two numbers are approximately equal to each other.

Use Math.abs() to compare the absolute difference of the two values to epsilon. Omit the third parameter, epsilon, to use a default value of 0.001.

const approximatelyEqual = (v1, v2, epsilon = 0.001) => Math.abs(v1 - v2) < epsilon;
-
approximatelyEqual(Math.PI / 2.0, 1.5708); // true
-

average

Returns the average of two or more numbers.

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0, divide by the length of the array.

const average = (...nums) => [...nums].reduce((acc, val) => acc + val, 0) / nums.length;
-
average(...[1, 2, 3]); // 2
-average(1, 2, 3); // 2
-

averageBy

Returns the average of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Array.reduce() to add each value to an accumulator, initialized with a value of 0, divide by the length of the array.

const averageBy = (arr, fn) =>
-  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val) => acc + val, 0) /
-  arr.length;
-
averageBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 5
-averageBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 5
-

binomialCoefficient

Evaluates the binomial coefficient of two integers n and k.

Use Number.isNaN() to check if any of the two values is NaN. Check if k is less than 0, greater than or equal to n, equal to 1 or n - 1 and return the appropriate result. Check if n - k is less than k and switch their values accordingly. Loop from 2 through k and calculate the binomial coefficient. Use Math.round() to account for rounding errors in the calculation.

const binomialCoefficient = (n, k) => {
-  if (Number.isNaN(n) || Number.isNaN(k)) return NaN;
-  if (k < 0 || k > n) return 0;
-  if (k === 0 || k === n) return 1;
-  if (k === 1 || k === n - 1) return n;
-  if (n - k < k) k = n - k;
-  let res = n;
-  for (let j = 2; j <= k; j++) res *= (n - j + 1) / j;
-  return Math.round(res);
-};
-
binomialCoefficient(8, 2); // 28
-

clampNumber

Clamps num within the inclusive range specified by the boundary values a and b.

If num falls within the range, return num. Otherwise, return the nearest number in the range.

const clampNumber = (num, a, b) => Math.max(Math.min(num, Math.max(a, b)), Math.min(a, b));
-
clampNumber(2, 3, 5); // 3
-clampNumber(1, -1, -5); // -1
-

degreesToRads

Converts an angle from degrees to radians.

Use Math.PI and the degree to radian formula to convert the angle from degrees to radians.

const degreesToRads = deg => deg * Math.PI / 180.0;
-
degreesToRads(90.0); // ~1.5708
-

digitize

Converts a number to an array of digits.

Convert the number to a string, using the spread operator (...) to build an array. Use Array.map() and parseInt() to transform each value to an integer.

const digitize = n => [...`${n}`].map(i => parseInt(i));
-
digitize(123); // [1, 2, 3]
-

distance

Returns the distance between two points.

Use Math.hypot() to calculate the Euclidean distance between two points.

const distance = (x0, y0, x1, y1) => Math.hypot(x1 - x0, y1 - y0);
-
distance(1, 1, 2, 3); // 2.23606797749979
-

eloadvanced

Computes the new ratings between two or more opponents using the Elo rating system. It takes an array of pre-ratings and returns an array containing post-ratings. The array should be ordered from best performer to worst performer (winner -> loser).

Use the exponent ** operator and math operators to compute the expected score (chance of winning). of each opponent and compute the new rating for each. Loop through the ratings, using each permutation to compute the post-Elo rating for each player in a pairwise fashion. Omit the second argument to use the default kFactor of 32.

const elo = ([...ratings], kFactor = 32, selfRating) => {
-  const [a, b] = ratings;
-  const expectedScore = (self, opponent) => 1 / (1 + 10 ** ((opponent - self) / 400));
-  const newRating = (rating, i) =>
-    (selfRating || rating) + kFactor * (i - expectedScore(i ? a : b, i ? b : a));
-  if (ratings.length === 2) {
-    return [newRating(a, 1), newRating(b, 0)];
-  } else {
-    for (let i = 0; i < ratings.length; i++) {
-      let j = i;
-      while (j < ratings.length - 1) {
-        [ratings[i], ratings[j + 1]] = elo([ratings[i], ratings[j + 1]], kFactor);
-        j++;
-      }
-    }
-  }
-  return ratings;
-};
-
// Standard 1v1s
-elo([1200, 1200]); // [1216, 1184]
-elo([1200, 1200], 64); // [1232, 1168]
-// 4 player FFA, all same rank
-elo([1200, 1200, 1200, 1200]).map(Math.round); // [1246, 1215, 1185, 1154]
-/*
-For teams, each rating can adjusted based on own team's average rating vs.
-average rating of opposing team, with the score being added to their
-own individual rating by supplying it as the third argument.
-*/
-

factorial

Calculates the factorial of a number.

Use recursion. If n is less than or equal to 1, return 1. Otherwise, return the product of n and the factorial of n - 1. Throws an exception if n is a negative number.

const factorial = n =>
-  n < 0
-    ? (() => {
-        throw new TypeError('Negative numbers are not allowed!');
-      })()
-    : n <= 1 ? 1 : n * factorial(n - 1);
-
factorial(6); // 720
-

fibonacci

Generates an array, containing the Fibonacci sequence, up until the nth term.

Create an empty array of the specific length, initializing the first two values (0 and 1). Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.

const fibonacci = n =>
-  Array.from({ length: n }).reduce(
-    (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
-    []
-  );
-
fibonacci(6); // [0, 1, 1, 2, 3, 5]
-

gcd

Calculates the greatest common divisor between two or more numbers/arrays.

The inner _gcd function uses recursion. Base case is when y equals 0. In this case, return x. Otherwise, return the GCD of y and the remainder of the division x/y.

const gcd = (...arr) => {
-  const _gcd = (x, y) => (!y ? x : gcd(y, x % y));
-  return [...arr].reduce((a, b) => _gcd(a, b));
-};
-
gcd(8, 36); // 4
-gcd(...[12, 8, 32]); // 4
-

geometricProgression

Initializes an array containing the numbers in the specified range where start and end are inclusive and the ratio between two terms is step. Returns an error if step equals 1.

Use Array.from(), Math.log() and Math.floor() to create an array of the desired length, Array.map() to fill with the desired values in a range. Omit the second argument, start, to use a default value of 1. Omit the third argument, step, to use a default value of 2.

const geometricProgression = (end, start = 1, step = 2) =>
-  Array.from({ length: Math.floor(Math.log(end / start) / Math.log(step)) + 1 }).map(
-    (v, i) => start * step ** i
-  );
-
geometricProgression(256); // [1, 2, 4, 8, 16, 32, 64, 128, 256]
-geometricProgression(256, 3); // [3, 6, 12, 24, 48, 96, 192]
-geometricProgression(256, 1, 4); // [1, 4, 16, 64, 256]
-

hammingDistance

Calculates the Hamming distance between two values.

Use XOR operator (^) to find the bit difference between the two numbers, convert to a binary string using toString(2). Count and return the number of 1s in the string, using match(/1/g).

const hammingDistance = (num1, num2) => ((num1 ^ num2).toString(2).match(/1/g) || '').length;
-
hammingDistance(2, 3); // 1
-

inRange

Checks if the given number falls within the given range.

Use arithmetic comparison to check if the given number is in the specified range. If the second parameter, end, is not specified, the range is considered to be from 0 to start.

const inRange = (n, start, end = null) => {
-  if (end && start > end) end = [start, (start = end)][0];
-  return end == null ? n >= 0 && n < start : n >= start && n < end;
-};
-
inRange(3, 2, 5); // true
-inRange(3, 4); // true
-inRange(2, 3, 5); // false
-inrange(3, 2); // false
-

isDivisible

Checks if the first numeric argument is divisible by the second one.

Use the modulo operator (%) to check if the remainder is equal to 0.

const isDivisible = (dividend, divisor) => dividend % divisor === 0;
-
isDivisible(6, 3); // true
-

isEven

Returns true if the given number is even, false otherwise.

Checks whether a number is odd or even using the modulo (%) operator. Returns true if the number is even, false if the number is odd.

const isEven = num => num % 2 === 0;
-
isEven(3); // false
-

isPrime

Checks if the provided integer is a prime number.

Check numbers from 2 to the square root of the given number. Return false if any of them divides the given number, else return true, unless the number is less than 2.

const isPrime = num => {
-  const boundary = Math.floor(Math.sqrt(num));
-  for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
-  return num >= 2;
-};
-
isPrime(11); // true
-

lcm

Returns the least common multiple of two or more numbers.

Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. The GCD formula uses recursion.

const lcm = (...arr) => {
-  const gcd = (x, y) => (!y ? x : gcd(y, x % y));
-  const _lcm = (x, y) => x * y / gcd(x, y);
-  return [...arr].reduce((a, b) => _lcm(a, b));
-};
-
lcm(12, 7); // 84
-lcm(...[1, 3, 4, 5]); // 60
-

luhnCheck

Implementation of the Luhn Algorithm used to validate a variety of identification numbers, such as credit card numbers, IMEI numbers, National Provider Identifier numbers etc.

Use String.split(''), Array.reverse() and Array.map() in combination with parseInt() to obtain an array of digits. Use Array.splice(0,1) to obtain the last digit. Use Array.reduce() to implement the Luhn Algorithm. Return true if sum is divisible by 10, false otherwise.

const luhnCheck = num => {
-  let arr = (num + '')
-    .split('')
-    .reverse()
-    .map(x => parseInt(x));
-  let lastDigit = arr.splice(0, 1)[0];
-  let sum = arr.reduce((acc, val, i) => (i % 2 !== 0 ? acc + val : acc + (val * 2) % 9 || 9), 0);
-  sum += lastDigit;
-  return sum % 10 === 0;
-};
-
luhnCheck('4485275742308327'); // true
-luhnCheck(6011329933655299); //  false
-luhnCheck(123456789); // false
-

maxBy

Returns the maximum value of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Math.max() to get the maximum value.

const maxBy = (arr, fn) => Math.max(...arr.map(typeof fn === 'function' ? fn : val => val[fn]));
-
maxBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 8
-maxBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 8
-

median

Returns the median of an array of numbers.

Find the middle of the array, use Array.sort() to sort the values. Return the number at the midpoint if length is odd, otherwise the average of the two middle numbers.

const median = arr => {
-  const mid = Math.floor(arr.length / 2),
-    nums = [...arr].sort((a, b) => a - b);
-  return arr.length % 2 !== 0 ? nums[mid] : (nums[mid - 1] + nums[mid]) / 2;
-};
-
median([5, 6, 50, 1, -5]); // 5
-

minBy

Returns the minimum value of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Math.min() to get the maximum value.

const minBy = (arr, fn) => Math.min(...arr.map(typeof fn === 'function' ? fn : val => val[fn]));
-
minBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 2
-minBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 2
-

percentile

Uses the percentile formula to calculate how many numbers in the given array are less or equal to the given value.

Use Array.reduce() to calculate how many numbers are below the value and how many are the same value and apply the percentile formula.

const percentile = (arr, val) =>
-  100 * arr.reduce((acc, v) => acc + (v < val ? 1 : 0) + (v === val ? 0.5 : 0), 0) / arr.length;
-
percentile([1, 2, 3, 4, 5, 6, 7, 8, 9, 10], 6); // 55
-

powerset

Returns the powerset of a given array of numbers.

Use Array.reduce() combined with Array.map() to iterate over elements and combine into an array containing all combinations.

const powerset = arr => arr.reduce((a, v) => a.concat(a.map(r => [v].concat(r))), [[]]);
-
powerset([1, 2]); // [[], [1], [2], [2,1]]
-

primes

Generates primes up to a given number, using the Sieve of Eratosthenes.

Generate an array from 2 to the given number. Use Array.filter() to filter out the values divisible by any number from 2 to the square root of the provided number.

const primes = num => {
-  let arr = Array.from({ length: num - 1 }).map((x, i) => i + 2),
-    sqroot = Math.floor(Math.sqrt(num)),
-    numsTillSqroot = Array.from({ length: sqroot - 1 }).map((x, i) => i + 2);
-  numsTillSqroot.forEach(x => (arr = arr.filter(y => y % x !== 0 || y === x)));
-  return arr;
-};
-
primes(10); // [2,3,5,7]
-

radsToDegrees

Converts an angle from radians to degrees.

Use Math.PI and the radian to degree formula to convert the angle from radians to degrees.

const radsToDegrees = rad => rad * 180.0 / Math.PI;
-
radsToDegrees(Math.PI / 2); // 90
-

randomIntArrayInRange

Returns an array of n random integers in the specified range.

Use Array.from() to create an empty array of the specific length, Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

const randomIntArrayInRange = (min, max, n = 1) =>
-  Array.from({ length: n }, () => Math.floor(Math.random() * (max - min + 1)) + min);
-
randomIntArrayInRange(12, 35, 10); // [ 34, 14, 27, 17, 30, 27, 20, 26, 21, 14 ]
-

randomIntegerInRange

Returns a random integer in the specified range.

Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
-
randomIntegerInRange(0, 5); // 2
-

randomNumberInRange

Returns a random number in the specified range.

Use Math.random() to generate a random value, map it to the desired range using multiplication.

const randomNumberInRange = (min, max) => Math.random() * (max - min) + min;
-
randomNumberInRange(2, 10); // 6.0211363285087005
-

round

Rounds a number to a specified amount of digits.

Use Math.round() and template literals to round the number to the specified number of digits. Omit the second argument, decimals to round to an integer.

const round = (n, decimals = 0) => Number(`${Math.round(`${n}e${decimals}`)}e-${decimals}`);
-
round(1.005, 2); // 1.01
-

sdbm

Hashes the input string into a whole number.

Use String.split('') and Array.reduce() to create a hash of the input string, utilizing bit shifting.

const sdbm = str => {
-  let arr = str.split('');
-  return arr.reduce(
-    (hashCode, currentVal) =>
-      (hashCode = currentVal.charCodeAt(0) + (hashCode << 6) + (hashCode << 16) - hashCode),
-    0
-  );
-};
-
sdbm('name'); // -3521204949
-

standardDeviation

Returns the standard deviation of an array of numbers.

Use Array.reduce() to calculate the mean, variance and the sum of the variance of the values, the variance of the values, then determine the standard deviation. You can omit the second argument to get the sample standard deviation or set it to true to get the population standard deviation.

const standardDeviation = (arr, usePopulation = false) => {
-  const mean = arr.reduce((acc, val) => acc + val, 0) / arr.length;
-  return Math.sqrt(
-    arr.reduce((acc, val) => acc.concat((val - mean) ** 2), []).reduce((acc, val) => acc + val, 0) /
-      (arr.length - (usePopulation ? 0 : 1))
-  );
-};
-
standardDeviation([10, 2, 38, 23, 38, 23, 21]); // 13.284434142114991 (sample)
-standardDeviation([10, 2, 38, 23, 38, 23, 21], true); // 12.29899614287479 (population)
-

sum

Returns the sum of two or more numbers/arrays.

Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.

const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
-
sum(...[1, 2, 3, 4]); // 10
-

sumBy

Returns the sum of an array, after mapping each element to a value using the provided function.

Use Array.map() to map each element to the value returned by fn, Array.reduce() to add each value to an accumulator, initialized with a value of 0.

const sumBy = (arr, fn) =>
-  arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val) => acc + val, 0);
-
sumBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], o => o.n); // 20
-sumBy([{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }], 'n'); // 20
-

sumPower

Returns the sum of the powers of all the numbers from start to end (both inclusive).

Use Array.fill() to create an array of all the numbers in the target range, Array.map() and the exponent operator (**) to raise them to power and Array.reduce() to add them together. Omit the second argument, power, to use a default power of 2. Omit the third argument, start, to use a default starting value of 1.

const sumPower = (end, power = 2, start = 1) =>
-  Array(end + 1 - start)
-    .fill(0)
-    .map((x, i) => (i + start) ** power)
-    .reduce((a, b) => a + b, 0);
-
sumPower(10); // 385
-sumPower(10, 3); //3025
-sumPower(10, 3, 5); //2925
-

toSafeInteger

Converts a value to a safe integer.

Use Math.max() and Math.min() to find the closest safe value. Use Math.round() to convert to an integer.

const toSafeInteger = num =>
-  Math.round(Math.max(Math.min(num, Number.MAX_SAFE_INTEGER), Number.MIN_SAFE_INTEGER));
-
toSafeInteger('3.2'); // 3
-toSafeInteger(Infinity); // 9007199254740991
-

Node

atob

Decodes a string of data which has been encoded using base-64 encoding.

Create a Buffer for the given string with base-64 encoding and use Buffer.toString('binary') to return the decoded string.

const atob = str => new Buffer(str, 'base64').toString('binary');
-
atob('Zm9vYmFy'); // 'foobar'
-

btoa

Creates a base-64 encoded ASCII string from a String object in which each character in the string is treated as a byte of binary data.

Create a Buffer for the given string with binary encoding and use Buffer.toString('base64') to return the encoded string.

const btoa = str => new Buffer(str, 'binary').toString('base64');
-
btoa('foobar'); // 'Zm9vYmFy'
-

colorize

Add special characters to text to print in color in the console (combined with console.log()).

Use template literals and special characters to add the appropriate color code to the string output. For background colors, add a special character that resets the background color at the end of the string.

const colorize = (...args) => ({
-  black: `\x1b[30m${args.join(' ')}`,
-  red: `\x1b[31m${args.join(' ')}`,
-  green: `\x1b[32m${args.join(' ')}`,
-  yellow: `\x1b[33m${args.join(' ')}`,
-  blue: `\x1b[34m${args.join(' ')}`,
-  magenta: `\x1b[35m${args.join(' ')}`,
-  cyan: `\x1b[36m${args.join(' ')}`,
-  white: `\x1b[37m${args.join(' ')}`,
-  bgBlack: `\x1b[40m${args.join(' ')}\x1b[0m`,
-  bgRed: `\x1b[41m${args.join(' ')}\x1b[0m`,
-  bgGreen: `\x1b[42m${args.join(' ')}\x1b[0m`,
-  bgYellow: `\x1b[43m${args.join(' ')}\x1b[0m`,
-  bgBlue: `\x1b[44m${args.join(' ')}\x1b[0m`,
-  bgMagenta: `\x1b[45m${args.join(' ')}\x1b[0m`,
-  bgCyan: `\x1b[46m${args.join(' ')}\x1b[0m`,
-  bgWhite: `\x1b[47m${args.join(' ')}\x1b[0m`
-});
-
console.log(colorize('foo').red); // 'foo' (red letters)
-console.log(colorize('foo', 'bar').bgBlue); // 'foo bar' (blue background)
-console.log(colorize(colorize('foo').yellow, colorize('foo').green).bgWhite); // 'foo bar' (first word in yellow letters, second word in green letters, white background for both)
-

hasFlags

Check if the current process's arguments contain the specified flags.

Use Array.every() and Array.includes() to check if process.argv contains all the specified flags. Use a regular expression to test if the specified flags are prefixed with - or -- and prefix them accordingly.

const hasFlags = (...flags) =>
-  flags.every(flag => process.argv.includes(/^-{1,2}/.test(flag) ? flag : '--' + flag));
-
// node myScript.js -s --test --cool=true
-hasFlags('-s'); // true
-hasFlags('--test', 'cool=true', '-s'); // true
-hasFlags('special'); // false
-

hashNode

Creates a hash for a value using the SHA-256 algorithm. Returns a promise.

Use crypto API to create a hash for the given value.

const crypto = require('crypto');
-const hashNode = val =>
-  new Promise(resolve =>
-    setTimeout(
-      () =>
-        resolve(
-          crypto
-            .createHash('sha256')
-            .update(val)
-            .digest('hex')
-        ),
-      0
-    )
-  );
-
hashNode(JSON.stringify({ a: 'a', b: [1, 2, 3, 4], foo: { c: 'bar' } })).then(console.log); // '04aa106279f5977f59f9067fa9712afc4aedc6f5862a8defc34552d8c7206393'
-

isTravisCI

Checks if the current environment is Travis CI.

Checks if the current environment has the TRAVIS and CI environment variables (reference).

const isTravisCI = () => 'TRAVIS' in process.env && 'CI' in process.env;
-
isTravisCI(); // true (if code is running on Travis CI)
-

JSONToFile

Writes a JSON object to a file.

Use fs.writeFile(), template literals and JSON.stringify() to write a json object to a .json file.

const fs = require('fs');
-const JSONToFile = (obj, filename) =>
-  fs.writeFile(`${filename}.json`, JSON.stringify(obj, null, 2));
-
JSONToFile({ test: 'is passed' }, 'testJsonFile'); // writes the object to 'testJsonFile.json'
-

readFileLines

Returns an array of lines from the specified file.

Use readFileSync function in fs node package to create a Buffer from a file. convert buffer to string using toString(encoding) function. creating an array from contents of file by spliting file content line by line (each \n).

const fs = require('fs');
-const readFileLines = filename =>
-  fs
-    .readFileSync(filename)
-    .toString('UTF8')
-    .split('\n');
-
/*
-contents of test.txt :
-  line1
-  line2
-  line3
-  ___________________________
-*/
-let arr = readFileLines('test.txt');
-console.log(arr); // ['line1', 'line2', 'line3']
-

untildify

Converts a tilde path to an absolute path.

Use String.replace() with a regular expression and OS.homedir() to replace the ~ in the start of the path with the home directory.

const untildify = str => str.replace(/^~($|\/|\\)/, `${require('os').homedir()}$1`);
-
untildify('~/node'); // '/Users/aUser/node'
-

UUIDGeneratorNode

Generates a UUID in Node.JS.

Use crypto API to generate a UUID, compliant with RFC4122 version 4.

const crypto = require('crypto');
-const UUIDGeneratorNode = () =>
-  ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c =>
-    (c ^ (crypto.randomBytes(1)[0] & (15 >> (c / 4)))).toString(16)
-  );
-
UUIDGeneratorNode(); // '79c7c136-60ee-40a2-beb2-856f1feabefc'
-

Object

bindAll

Binds methods of an object to the object itself, overwriting the existing method.

Use Array.forEach() to return a function that uses Function.apply() to apply the given context (obj) to fn for each function specified.

const bindAll = (obj, ...fns) =>
-  fns.forEach(
-    fn => (
-      (f = obj[fn]),
-      (obj[fn] = function() {
-        return f.apply(obj);
-      })
-    )
-  );
-
var view = {
-  label: 'docs',
-  click: function() {
-    console.log('clicked ' + this.label);
-  }
-};
-bindAll(view, 'click');
-jQuery(element).on('click', view.click); // Logs 'clicked docs' when clicked.
-

deepClone

Creates a deep clone of an object.

Use recursion. Use Object.assign() and an empty object ({}) to create a shallow clone of the original. Use Object.keys() and Array.forEach() to determine which key-value pairs need to be deep cloned.

const deepClone = obj => {
-  let clone = Object.assign({}, obj);
-  Object.keys(clone).forEach(
-    key => (clone[key] = typeof obj[key] === 'object' ? deepClone(obj[key]) : obj[key])
-  );
-  return clone;
-};
-
const a = { foo: 'bar', obj: { a: 1, b: 2 } };
-const b = deepClone(a); // a !== b, a.obj !== b.obj
-

defaults

Assigns default values for all properties in an object that are undefined.

Use Object.assign() to create a new empty object and copy the original one to maintain key order, use Array.reverse() and the spread operator ... to combine the default values from left to right, finally use obj again to overwrite properties that originally had a value.

const defaults = (obj, ...defs) => Object.assign({}, obj, ...defs.reverse(), obj);
-
defaults({ a: 1 }, { b: 2 }, { b: 6 }, { a: 3 }); // { a: 1, b: 2 }
-

equalsadvanced

Performs a deep comparison between two values to determine if they are equivalent.

Check if the two values are identical, if they are both Date objects with the same time, using Date.getTime() or if they are both non-object values with an equivalent value (strict comparison). Check if only one value is null or undefined or if their prototypes differ. If none of the above conditions are met, use Object.keys() to check if both values have the same number of keys, then use Array.every() to check if every key in the first value exists in the second one and if they are equivalent by calling this method recursively.

const equals = (a, b) => {
-  if (a === b) return true;
-  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();
-  if (!a || !b || (typeof a != 'object' && typeof b !== 'object')) return a === b;
-  if (a === null || a === undefined || b === null || b === undefined) return false;
-  if (a.prototype !== b.prototype) return false;
-  let keys = Object.keys(a);
-  if (keys.length !== Object.keys(b).length) return false;
-  return keys.every(k => equals(a[k], b[k]));
-};
-
equals({ a: [2, { e: 3 }], b: [4], c: 'foo' }, { a: [2, { e: 3 }], b: [4], c: 'foo' }); // true
-

findKey

Returns the first key that satisfies the provided testing function. Otherwise undefined is returned.

Use Object.keys(obj) to get all the properties of the object, Array.find() to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const findKey = (obj, fn) => Object.keys(obj).find(key => fn(obj[key], key, obj));
-
findKey(
-  {
-    barney: { age: 36, active: true },
-    fred: { age: 40, active: false },
-    pebbles: { age: 1, active: true }
-  },
-  o => o['active']
-); // 'barney'
-

findLastKey

Returns the last key that satisfies the provided testing function. Otherwise undefined is returned.

Use Object.keys(obj) to get all the properties of the object, Array.reverse() to reverse their order and Array.find() to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const findLastKey = (obj, fn) =>
-  Object.keys(obj)
-    .reverse()
-    .find(key => fn(obj[key], key, obj));
-
findLastKey(
-  {
-    barney: { age: 36, active: true },
-    fred: { age: 40, active: false },
-    pebbles: { age: 1, active: true }
-  },
-  o => o['active']
-); // 'pebbles'
-

flattenObject

Flatten an object with the paths for keys.

Use recursion. Use Object.keys(obj) combined with Array.reduce() to convert every leaf node to a flattened path node. If the value of a key is an object, the function calls itself with the appropriate prefix to create the path using Object.assign(). Otherwise, it adds the appropriate prefixed key-value pair to the accumulator object. You should always omit the second argument, prefix, unless you want every key to have a prefix.

const flattenObject = (obj, prefix = '') =>
-  Object.keys(obj).reduce((acc, k) => {
-    const pre = prefix.length ? prefix + '.' : '';
-    if (typeof obj[k] === 'object') Object.assign(acc, flattenObject(obj[k], pre + k));
-    else acc[pre + k] = obj[k];
-    return acc;
-  }, {});
-
flattenObject({ a: { b: { c: 1 } }, d: 1 }); // { 'a.b.c': 1, d: 1 }
-

forOwn

Iterates over all own properties of an object, running a callback for each one.

Use Object.keys(obj) to get all the properties of the object, Array.forEach() to run the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const forOwn = (obj, fn) => Object.keys(obj).forEach(key => fn(obj[key], key, obj));
-
forOwn({ foo: 'bar', a: 1 }, v => console.log(v)); // 'bar', 1
-

forOwnRight

Iterates over all own properties of an object in reverse, running a callback for each one.

Use Object.keys(obj) to get all the properties of the object, Array.reverse() to reverse their order and Array.forEach() to run the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.

const forOwnRight = (obj, fn) =>
-  Object.keys(obj)
-    .reverse()
-    .forEach(key => fn(obj[key], key, obj));
-
forOwnRight({ foo: 'bar', a: 1 }, v => console.log(v)); // 1, 'bar'
-

functions

Returns an array of function property names from own (and optionally inherited) enumerable properties of an object.

Use Object.keys(obj) to iterate over the object's own properties. If inherited is true, use Object.get.PrototypeOf(obj) to also get the object's inherited properties. Use Array.filter() to keep only those properties that are functions. Omit the second argument, inherited, to not include inherited properties by default.

const functions = (obj, inherited = false) =>
-  (inherited
-    ? [...Object.keys(obj), ...Object.keys(Object.getPrototypeOf(obj))]
-    : Object.keys(obj)
-  ).filter(key => typeof obj[key] === 'function');
-
function Foo() {
-  this.a = () => 1;
-  this.b = () => 2;
-}
-Foo.prototype.c = () => 3;
-functions(new Foo()); // ['a', 'b']
-functions(new Foo(), true); // ['a', 'b', 'c']
-

get

Retrieve a set of properties indicated by the given selectors from an object.

Use Array.map() for each selector, String.replace() to replace square brackets with dots, String.split('.') to split each selector, Array.filter() to remove empty values and Array.reduce() to get the value indicated by it.

const get = (from, ...selectors) =>
-  [...selectors].map(s =>
-    s
-      .replace(/\[([^\[\]]*)\]/g, '.$1.')
-      .split('.')
-      .filter(t => t !== '')
-      .reduce((prev, cur) => prev && prev[cur], from)
-  );
-
const obj = { selector: { to: { val: 'val to select' } }, target: [1, 2, { a: 'test' }] };
-get(obj, 'selector.to.val', 'target[0]', 'target[2].a'); // ['val to select', 1, 'test']
-

invertKeyValues

Inverts the key-value pairs of an object, without mutating it. The corresponding inverted value of each inverted key is an array of keys responsible for generating the inverted value. If a function is supplied, it is applied to each inverted key.

Use Object.keys() and Array.reduce() to invert the key-value pairs of an object and apply the function provided (if any). Omit the second argument, fn, to get the inverted keys without applying a function to them.

const invertKeyValues = (obj, fn) =>
-  Object.keys(obj).reduce((acc, key) => {
-    const val = fn ? fn(obj[key]) : obj[key];
-    acc[val] = acc[val] || [];
-    acc[val].push(key);
-    return acc;
-  }, {});
-
invertKeyValues({ a: 1, b: 2, c: 1 }); // { 1: [ 'a', 'c' ], 2: [ 'b' ] }
-invertKeyValues({ a: 1, b: 2, c: 1 }, value => 'group' + value); // { group1: [ 'a', 'c' ], group2: [ 'b' ] }
-

lowercaseKeys

Creates a new object from the specified object, where all the keys are in lowercase.

Use Object.keys() and Array.reduce() to create a new object from the specified object. Convert each key in the original object to lowercase, using String.toLowerCase().

const lowercaseKeys = obj =>
-  Object.keys(obj).reduce((acc, key) => {
-    acc[key.toLowerCase()] = obj[key];
-    return acc;
-  }, {});
-
const myObj = { Name: 'Adam', sUrnAME: 'Smith' };
-const myObjLower = lowercaseKeys(myObj); // {name: 'Adam', surname: 'Smith'};
-

mapKeys

Creates an object with keys generated by running the provided function for each key and the same values as the provided object.

Use Object.keys(obj) to iterate over the object's keys. Use Array.reduce() to create a new object with the same values and mapped keys using fn.

const mapKeys = (obj, fn) =>
-  Object.keys(obj).reduce((acc, k) => {
-    acc[fn(obj[k], k, obj)] = obj[k];
-    return acc;
-  }, {});
-
mapKeys({ a: 1, b: 2 }, (val, key) => key + val); // { a1: 1, b2: 2 }
-

mapValues

Creates an object with the same keys as the provided object and values generated by running the provided function for each value.

Use Object.keys(obj) to iterate over the object's keys. Use Array.reduce() to create a new object with the same keys and mapped values using fn.

const mapValues = (obj, fn) =>
-  Object.keys(obj).reduce((acc, k) => {
-    acc[k] = fn(obj[k], k, obj);
-    return acc;
-  }, {});
-
const users = {
-  fred: { user: 'fred', age: 40 },
-  pebbles: { user: 'pebbles', age: 1 }
-};
-mapValues(users, u => u.age); // { fred: 40, pebbles: 1 }
-

matches

Compares two objects to determine if the first one contains equivalent property values to the second one.

Use Object.keys(source) to get all the keys of the second object, then Array.every(), Object.hasOwnProperty() and strict comparison to determine if all keys exist in the first object and have the same values.

const matches = (obj, source) =>
-  Object.keys(source).every(key => obj.hasOwnProperty(key) && obj[key] === source[key]);
-
matches({ age: 25, hair: 'long', beard: true }, { hair: 'long', beard: true }); // true
-matches({ hair: 'long', beard: true }, { age: 25, hair: 'long', beard: true }); // false
-

matchesWith

Compares two objects to determine if the first one contains equivalent property values to the second one, based on a provided function.

Use Object.keys(source) to get all the keys of the second object, then Array.every(), Object.hasOwnProperty() and the provided function to determine if all keys exist in the first object and have equivalent values. If no function is provided, the values will be compared using the equality operator.

const matchesWith = (obj, source, fn) =>
-  Object.keys(source).every(
-    key =>
-      obj.hasOwnProperty(key) && fn
-        ? fn(obj[key], source[key], key, obj, source)
-        : obj[key] == source[key]
-  );
-
const isGreeting = val => /^h(?:i|ello)$/.test(val);
-matchesWith(
-  { greeting: 'hello' },
-  { greeting: 'hi' },
-  (oV, sV) => isGreeting(oV) && isGreeting(sV)
-); // true
-

merge

Creates a new object from the combination of two or more objects.

Use Array.reduce() combined with Object.keys(obj) to iterate over all objects and keys. Use hasOwnProperty() and Array.concat() to append values for keys existing in multiple objects.

const merge = (...objs) =>
-  [...objs].reduce(
-    (acc, obj) =>
-      Object.keys(obj).reduce((a, k) => {
-        acc[k] = acc.hasOwnProperty(k) ? [].concat(acc[k]).concat(obj[k]) : obj[k];
-        return acc;
-      }, {}),
-    {}
-  );
-
const object = {
-  a: [{ x: 2 }, { y: 4 }],
-  b: 1
-};
-const other = {
-  a: { z: 3 },
-  b: [2, 3],
-  c: 'foo'
-};
-merge(object, other); // { a: [ { x: 2 }, { y: 4 }, { z: 3 } ], b: [ 1, 2, 3 ], c: 'foo' }
-

nest

Given a flat array of objects linked to one another, it will nest them recursively. Useful for nesting comments, such as the ones on reddit.com.

Use recursion. Use Array.filter() to filter the items where the id matches the link, then Array.map() to map each one to a new object that has a children property which recursively nests the items based on which ones are children of the current item. Omit the second argument, id, to default to null which indicates the object is not linked to another one (i.e. it is a top level object). Omit the third argument, link, to use 'parent_id' as the default property which links the object to another one by its id.

const nest = (items, id = null, link = 'parent_id') =>
-  items
-    .filter(item => item[link] === id)
-    .map(item => ({ ...item, children: nest(items, item.id) }));
-
// One top level comment
-const comments = [
-  { id: 1, parent_id: null },
-  { id: 2, parent_id: 1 },
-  { id: 3, parent_id: 1 },
-  { id: 4, parent_id: 2 },
-  { id: 5, parent_id: 4 }
-];
-const nestedComments = nest(comments); // [{ id: 1, parent_id: null, children: [...] }]
-

objectFromPairs

Creates an object from the given key-value pairs.

Use Array.reduce() to create and combine key-value pairs.

const objectFromPairs = arr => arr.reduce((a, v) => ((a[v[0]] = v[1]), a), {});
-
objectFromPairs([['a', 1], ['b', 2]]); // {a: 1, b: 2}
-

objectToPairs

Creates an array of key-value pair arrays from an object.

Use Object.keys() and Array.map() to iterate over the object's keys and produce an array with key-value pairs.

const objectToPairs = obj => Object.keys(obj).map(k => [k, obj[k]]);
-
objectToPairs({ a: 1, b: 2 }); // [['a',1],['b',2]]
-

omit

Omits the key-value pairs corresponding to the given keys from an object.

Use Object.keys(obj), Array.filter() and Array.includes() to remove the provided keys. Use Array.reduce() to convert the filtered keys back to an object with the corresponding key-value pairs.

const omit = (obj, arr) =>
-  Object.keys(obj)
-    .filter(k => !arr.includes(k))
-    .reduce((acc, key) => ((acc[key] = obj[key]), acc), {});
-
omit({ a: 1, b: '2', c: 3 }, ['b']); // { 'a': 1, 'c': 3 }
-

omitBy

Creates an object composed of the properties the given function returns falsey for. The function is invoked with two arguments: (value, key).

Use Object.keys(obj) and Array.filter()to remove the keys for which fn returns a truthy value. Use Array.reduce() to convert the filtered keys back to an object with the corresponding key-value pairs.

const omitBy = (obj, fn) =>
-  Object.keys(obj)
-    .filter(k => !fn(obj[k], k))
-    .reduce((acc, key) => ((acc[key] = obj[key]), acc), {});
-
omitBy({ a: 1, b: '2', c: 3 }, x => typeof x === 'number'); // { b: '2' }
-

orderBy

Returns a sorted array of objects ordered by properties and orders.

Uses Array.sort(), Array.reduce() on the props array with a default value of 0, use array destructuring to swap the properties position depending on the order passed. If no orders array is passed it sort by 'asc' by default.

const orderBy = (arr, props, orders) =>
-  [...arr].sort((a, b) =>
-    props.reduce((acc, prop, i) => {
-      if (acc === 0) {
-        const [p1, p2] = orders && orders[i] === 'desc' ? [b[prop], a[prop]] : [a[prop], b[prop]];
-        acc = p1 > p2 ? 1 : p1 < p2 ? -1 : 0;
-      }
-      return acc;
-    }, 0)
-  );
-
const users = [{ name: 'fred', age: 48 }, { name: 'barney', age: 36 }, { name: 'fred', age: 40 }];
-orderBy(users, ['name', 'age'], ['asc', 'desc']); // [{name: 'barney', age: 36}, {name: 'fred', age: 48}, {name: 'fred', age: 40}]
-orderBy(users, ['name', 'age']); // [{name: 'barney', age: 36}, {name: 'fred', age: 40}, {name: 'fred', age: 48}]
-

pick

Picks the key-value pairs corresponding to the given keys from an object.

Use Array.reduce() to convert the filtered/picked keys back to an object with the corresponding key-value pairs if the key exists in the object.

const pick = (obj, arr) =>
-  arr.reduce((acc, curr) => (curr in obj && (acc[curr] = obj[curr]), acc), {});
-
pick({ a: 1, b: '2', c: 3 }, ['a', 'c']); // { 'a': 1, 'c': 3 }
-

pickBy

Creates an object composed of the properties the given function returns truthy for. The function is invoked with two arguments: (value, key).

Use Object.keys(obj) and Array.filter()to remove the keys for which fn returns a falsey value. Use Array.reduce() to convert the filtered keys back to an object with the corresponding key-value pairs.

const pickBy = (obj, fn) =>
-  Object.keys(obj)
-    .filter(k => fn(obj[k], k))
-    .reduce((acc, key) => ((acc[key] = obj[key]), acc), {});
-
pickBy({ a: 1, b: '2', c: 3 }, x => typeof x === 'number'); // { 'a': 1, 'c': 3 }
-

shallowClone

Creates a shallow clone of an object.

Use Object.assign() and an empty object ({}) to create a shallow clone of the original.

const shallowClone = obj => Object.assign({}, obj);
-
const a = { x: true, y: 1 };
-const b = shallowClone(a); // a !== b
-

size

Get size of arrays, objects or strings.

Get type of val (array, object or string). Use length property for arrays. Use length or size value if available or number of keys for objects. Use size of a Blob object created from val for strings.

Split strings into array of characters with split('') and return its length.

const size = val =>
-  Array.isArray(val)
-    ? val.length
-    : val && typeof val === 'object'
-      ? val.size || val.length || Object.keys(val).length
-      : typeof val === 'string' ? new Blob([val]).size : 0;
-
size([1, 2, 3, 4, 5]); // 5
-size('size'); // 4
-size({ one: 1, two: 2, three: 3 }); // 3
-

transform

Applies a function against an accumulator and each key in the object (from left to right).

Use Object.keys(obj) to iterate over each key in the object, Array.reduce() to call the apply the specified function against the given accumulator.

const transform = (obj, fn, acc) => Object.keys(obj).reduce((a, k) => fn(a, obj[k], k, obj), acc);
-
transform(
-  { a: 1, b: 2, c: 1 },
-  (r, v, k) => {
-    (r[v] || (r[v] = [])).push(k);
-    return r;
-  },
-  {}
-); // { '1': ['a', 'c'], '2': ['b'] }
-

truthCheckCollection

Checks if the predicate (second argument) is truthy on all elements of a collection (first argument).

Use Array.every() to check if each passed object has the specified property and if it returns a truthy value.

const truthCheckCollection = (collection, pre) => collection.every(obj => obj[pre]);
-
truthCheckCollection([{ user: 'Tinky-Winky', sex: 'male' }, { user: 'Dipsy', sex: 'male' }], 'sex'); // true
-

unflattenObjectadvanced

Unlatten an object with the paths for keys.

Use Object.keys(obj) combined with Array.reduce() to convert flattened path node to a leaf node. If the value of a key contains a dot delimiter (.), use Array.split('.'), string transformations and JSON.parse() to create an object, then Object.assign() to create the leaf node. Otherwise, add the appropriate key-value pair to the accumulator object.

const unflattenObject = obj =>
-  Object.keys(obj).reduce((acc, k) => {
-    if (k.indexOf('.') !== -1) {
-      const keys = k.split('.');
-      Object.assign(
-        acc,
-        JSON.parse(
-          '{' +
-            keys.map((v, i) => (i !== keys.length - 1 ? `"${v}":{` : `"${v}":`)).join('') +
-            obj[k] +
-            '}'.repeat(keys.length)
-        )
-      );
-    } else acc[k] = obj[k];
-    return acc;
-  }, {});
-
unflattenObject({ 'a.b.c': 1, d: 1 }); // { a: { b: { c: 1 } }, d: 1 }
-

String

byteSize

Returns the length of a string in bytes.

Convert a given string to a Blob Object and find its size.

const byteSize = str => new Blob([str]).size;
-
byteSize('😀'); // 4
-byteSize('Hello World'); // 11
-

capitalize

Capitalizes the first letter of a string.

Use array destructuring and String.toUpperCase() to capitalize first letter, ...rest to get array of characters after first letter and then Array.join('') to make it a string again. Omit the lowerRest parameter to keep the rest of the string intact, or set it to true to convert to lowercase.

const capitalize = ([first, ...rest], lowerRest = false) =>
-  first.toUpperCase() + (lowerRest ? rest.join('').toLowerCase() : rest.join(''));
-
capitalize('fooBar'); // 'FooBar'
-capitalize('fooBar', true); // 'Foobar'
-

capitalizeEveryWord

Capitalizes the first letter of every word in a string.

Use String.replace() to match the first character of each word and String.toUpperCase() to capitalize it.

const capitalizeEveryWord = str => str.replace(/\b[a-z]/g, char => char.toUpperCase());
-
capitalizeEveryWord('hello world!'); // 'Hello World!'
-

decapitalize

Decapitalizes the first letter of a string.

Use array destructuring and String.toLowerCase() to decapitalize first letter, ...rest to get array of characters after first letter and then Array.join('') to make it a string again. Omit the upperRest parameter to keep the rest of the string intact, or set it to true to convert to uppercase.

const decapitalize = ([first, ...rest], upperRest = false) =>
-  first.toLowerCase() + (upperRest ? rest.join('').toUpperCase() : rest.join(''));
-
decapitalize('FooBar'); // 'fooBar'
-decapitalize('FooBar', true); // 'fOOBAR'
-

escapeHTML

Escapes a string for use in HTML.

Use String.replace() with a regexp that matches the characters that need to be escaped, using a callback function to replace each character instance with its associated escaped character using a dictionary (object).

const escapeHTML = str =>
-  str.replace(
-    /[&<>'"]/g,
-    tag =>
-      ({
-        '&': '&amp;',
-        '<': '&lt;',
-        '>': '&gt;',
-        "'": '&#39;',
-        '"': '&quot;'
-      }[tag] || tag)
-  );
-
escapeHTML('<a href="#">Me & you</a>'); // '&lt;a href=&quot;#&quot;&gt;Me &amp; you&lt;/a&gt;'
-

escapeRegExp

Escapes a string to use in a regular expression.

Use String.replace() to escape special characters.

const escapeRegExp = str => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-
escapeRegExp('(test)'); // \\(test\\)
-

fromCamelCase

Converts a string from camelcase.

Use String.replace() to remove underscores, hyphens, and spaces and convert words to camelcase. Omit the second argument to use a default separator of _.

const fromCamelCase = (str, separator = '_') =>
-  str
-    .replace(/([a-z\d])([A-Z])/g, '$1' + separator + '$2')
-    .replace(/([A-Z]+)([A-Z][a-z\d]+)/g, '$1' + separator + '$2')
-    .toLowerCase();
-
fromCamelCase('someDatabaseFieldName', ' '); // 'some database field name'
-fromCamelCase('someLabelThatNeedsToBeCamelized', '-'); // 'some-label-that-needs-to-be-camelized'
-fromCamelCase('someJavascriptProperty', '_'); // 'some_javascript_property'
-

isAbsoluteURL

Returns true if the given string is an absolute URL, false otherwise.

Use a regular expression to test if the string is an absolute URL.

const isAbsoluteURL = str => /^[a-z][a-z0-9+.-]*:/.test(str);
-
isAbsoluteURL('https://google.com'); // true
-isAbsoluteURL('ftp://www.myserver.net'); // true
-isAbsoluteURL('/foo/bar'); // false
-

isAnagram

Checks if a string is an anagram of another string (case-insensitive, ignores spaces, punctuation and special characters).

Use String.toLowerCase(), String.replace() with an appropriate regular expression to remove unnecessary characters, String.split(''), Array.sort() and Array.join('') on both strings to normalize them, then check if their normalized forms are equal.

const isAnagram = (str1, str2) => {
-  const normalize = str =>
-    str
-      .toLowerCase()
-      .replace(/[^a-z0-9]/gi, '')
-      .split('')
-      .sort()
-      .join('');
-  return normalize(str1) === normalize(str2);
-};
-
isAnagram('iceman', 'cinema'); // true
-

isLowerCase

Checks if a string is lower case.

Convert the given string to lower case, using String.toLowerCase() and compare it to the original.

const isLowerCase = str => str === str.toLowerCase();
-
isLowerCase('abc'); // true
-isLowerCase('a3@$'); // true
-isLowerCase('Ab4'); // false
-

isUpperCase

Checks if a string is upper case.

Convert the given string to upper case, using String.toUpperCase() and compare it to the original.

const isUpperCase = str => str === str.toUpperCase();
-
isUpperCase('ABC'); // true
-isLowerCase('A3@$'); // true
-isLowerCase('aB4'); // false
-

mask

Replaces all but the last num of characters with the specified mask character.

Use String.slice() to grab the portion of the characters that need to be masked and use String.replace() with a regexp to replace every character with the mask character. Concatenate the masked characters with the remaining unmasked portion of the string. Omit the second argument, num, to keep a default of 4 characters unmasked. If num is negative, the unmasked characters will be at the start of the string. Omit the third argument, mask, to use a default character of '*' for the mask.

const mask = (cc, num = 4, mask = '*') =>
-  ('' + cc).slice(0, -num).replace(/./g, mask) + ('' + cc).slice(-num);
-
mask(1234567890); // '******7890'
-mask(1234567890, 3); // '*******890'
-mask(1234567890, -4, '$'); // '$$$$567890'
-

pad

Pads a string on both sides with the specified character, if it's shorter than the specified length.

Use String.padStart() and String.padEnd() to pad both sides of the given string. Omit the third argument, char, to use the whitespace character as the default padding character.

const pad = (str, length, char = ' ') =>
-  str.padStart((str.length + length) / 2, char).padEnd(length, char);
-
pad('cat', 8); // '  cat   '
-pad(String(42), 6, '0'); // '004200'
-pad('foobar', 3); // 'foobar'
-

palindrome

Returns true if the given string is a palindrome, false otherwise.

Convert string String.toLowerCase() and use String.replace() to remove non-alphanumeric characters from it. Then, String.split('') into individual characters, Array.reverse(), String.join('') and compare to the original, unreversed string, after converting it String.tolowerCase().

const palindrome = str => {
+
+
+  
+    
+    30 seconds of code
+    
+    
+    
+    
+    
+    
+    
+    
+    
+  
+  
+    

+  
logo 30 seconds of code

+  
Curated collection of useful JavaScript snippets
 that you can understand in 30 seconds or less.

+  
+

+

+  

+    

+      

+        
+        
295
snippets

+      

+      

+        
+        
113
contributors

+      

+      

+        
+        
3029
commits

+      

+      

+        
+        
19461
stars

+      

+    

+  

+

+

+  

+    

+      
Our philosophy

+      
The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


+    

+  

+  

+    

+      

+        

+          

+          

+          
In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

+        

+      


+    

+  

+  

+    

+      
Today's picks

+      

+        
+      
+      
palindrome

+
Returns true if the given string is a palindrome, false otherwise.

+
Convert string String.toLowerCase() and use String.replace() to remove non-alphanumeric characters from it.
+Then, String.split('') into individual characters, Array.reverse(), String.join('') and compare to the original, unreversed string, after converting it String.tolowerCase().

+
const palindrome = str => {
   const s = str.toLowerCase().replace(/[\W_]/g, '');
   return (
     s ===
@@ -1683,401 +80,206 @@ Foo.prototypeShow examples
palindrome('taco cat'); // true
-
pluralize
Returns the singular or plural form of the word based on the input number. If the first argument is an object, it will use a closure by returning a function that can auto-pluralize words that don't simply end in s if the supplied dictionary contains the word.
If num is either -1 or 1, return the singular form of the word. If num is any other number, return the plural form. Omit the third argument to use the default of the singular word + s, or supply a custom pluralized word when necessary. If the first argument is an object, utilize a closure by returning a function which can use the supplied dictionary to resolve the correct plural form of the word.
const pluralize = (val, word, plural = word + 's') => {
-  const _pluralize = (num, word, plural = word + 's') =>
-    [1, -1].includes(Number(num)) ? word : plural;
-  if (typeof val === 'object') return (num, word) => _pluralize(num, word, val[word]);
-  return _pluralize(val, word, plural);
+

+
sampleSize

+
Gets n random elements at unique keys from array up to the size of array.

+
Shuffle the array using the Fisher-Yates algorithm.
+Use Array.slice() to get the first n elements.
+Omit the second argument, n to get only one element at random from the array.

+
const sampleSize = ([...arr], n = 1) => {
+  let m = arr.length;
+  while (m) {
+    const i = Math.floor(Math.random() * m--);
+    [arr[m], arr[i]] = [arr[i], arr[m]];
+  }
+  return arr.slice(0, n);
 };
-
pluralize(0, 'apple'); // 'apples'
-pluralize(1, 'apple'); // 'apple'
-pluralize(2, 'apple'); // 'apples'
-pluralize(2, 'person', 'people'); // 'people'
+
sampleSize([1, 2, 3], 2); // [3,1]
+sampleSize([1, 2, 3], 4); // [2,3,1]
+

+
spreadOver

+
Takes a variadic function and returns a closure that accepts an array of arguments to map to the inputs of the function.

+
Use closures and the spread operator (...) to map the array of arguments to the inputs of the function.

+
const spreadOver = fn => argsArr => fn(...argsArr);
+
const arrayMax = spreadOver(Math.max);
+arrayMax([1, 2, 3]); // 3
+

+

+      

+    

+    

+  

+

+

+  

+    

+      
Getting started

+      

+    

+  

+  

+    

+      
Related projects

+      
The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

+      

+    

+  

+  

+    

+      
Top contributors

+      

+        

+          
+          Angelos Chalaris
+          

+        

+        

+          
+          Stefan Feješ
+          

+        

+          
+          Felix Wu
+          

+        

+          
+          atomiks
+          

+        

+          
+          King David Martins
+          

+        

+          
+          Rohit Tanwar
+          

+        

+          
+          Soorena Soleimani
+          

+        

+          
+          Robert Mennell
+          

+    

+    

+  

+  

+    

+      
How to contribute

+      
Do you have a cool idea for a new snippet? Maybe some code you use often and is not part of our collection? Contributing to 30 seconds of code is as simple as 1,2,3,4!

+          

+            1
+            

+              
Create

+              
Start by creating a snippet, according to the snippet template. Make sure to follow these simple guidelines:

+              
    
+                
  • Your snippet title must be unique and the same as the name of the implemented function.
    • 
+                
  • Use the snippet description to explain what your snippet does and how it works.
    • 
+                
  • Try to keep the snippet's code short and to the point. Use modern techniques and features.
    • 
+                
  • Remember to provide an example of how your snippet works.
    • 
+                
  • Your snippet should solve a real-world problem, no matter how simple.
    • 
+                
  • Never modify README.md or any of the HTML files.
    • 
+              

+            

+          

+          

+            2
+            

+              
Tag

+              
Run npm run tagger from your terminal, then open the tag_database file and tag your snippet appropriately. Multitagging is also supported, just make sure the first tag you specify is on of the major tags and the one that is most relevant to the implemneted function.

+            

+          

+          

+            3
+            

+              
Test

+              
You can optionally test your snippet to make our job easier. Simply run npm run tester to generate the test files for your snippet. Find the related folder for you snippet under the test directory and write some tests. Remember to run npm run tester again to make sure your tests are passing.

+            

+          

+          

+            4
+            

+              
Pull request

+              
If you have done everything mentioned above, you should now have an awesome snippet to add to our collection. Simply start a pull request and follow the guidelines provided. Remember to only submit one snippet per pull request, so that we can quickly evaluate and merge your code into the collection.

+            

+          

+  
If you need additional pointers about writing a snippet, be sure to read the complete contribution guidelines.

+        

+  

+

+

+
+
+
+
diff --git a/docs/mini.css b/docs/mini.css
index 3a0a6c1c1..0f4cccbf9 100644
--- a/docs/mini.css
+++ b/docs/mini.css
@@ -1 +1 @@
-:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a—  " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff}
+:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a—  " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff}body{overflow-x:hidden}
diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss
index 81b81020c..a0c5eed5e 100644
--- a/docs/mini/flavor.scss
+++ b/docs/mini/flavor.scss
@@ -760,3 +760,7 @@ button.next {
   font-weight: 700;
   color: #fff;
 }
+
+body {
+  overflow-x: hidden;
+}
diff --git a/scripts/util.js b/scripts/util.js
index d7ceb9694..910d88553 100644
--- a/scripts/util.js
+++ b/scripts/util.js
@@ -62,6 +62,15 @@ const optimizeNodes = (data, regexp, replacer) => {
   } while (count > 0);
   return output;
 };
+// Randomizes the order of the values of an array, returning a new array.
+const shuffle = ([...arr]) => {
+  let m = arr.length;
+  while (m) {
+    const i = Math.floor(Math.random() * m--);
+    [arr[m], arr[i]] = [arr[i], arr[m]];
+  }
+  return arr;
+};
 // Capitalizes the first letter of a string
 const capitalize = (str, lowerRest = false) =>
   str.slice(0, 1).toUpperCase() + (lowerRest ? str.slice(1).toLowerCase() : str.slice(1));
@@ -69,4 +78,4 @@ const capitalize = (str, lowerRest = false) =>
 const isTravisCI = () => 'TRAVIS' in process.env && 'CI' in process.env;
 // Creates a hash for a value using the SHA-256 algorithm.
 const hashData = val => crypto.createHash('sha256').update(val).digest('hex');
-module.exports = {readSnippets, readTags, optimizeNodes, capitalize, objectFromPairs, isTravisCI, hashData};
+module.exports = {readSnippets, readTags, optimizeNodes, capitalize, objectFromPairs, isTravisCI, hashData, shuffle};
diff --git a/scripts/web.js b/scripts/web.js
index 8833613d9..26f6454ce 100644
--- a/scripts/web.js
+++ b/scripts/web.js
@@ -4,6 +4,7 @@
 */
 // Load modules
 const fs = require('fs-extra'),
+  https = require('https'),
   path = require('path'),
   chalk = require('chalk'),
   md = require('markdown-it')(),
@@ -58,6 +59,7 @@ let snippets = {},
   beginnerStartPart = '',
   beginnerEndPart = '',
   beginnerOutput = '',
+  indexStaticFile = '',
   pagesOutput = [];
   tagDbData = {};
 // Start the timer of the script
@@ -65,13 +67,15 @@ console.time('Webber');
 // Synchronously read all snippets and sort them as necessary (case-insensitive)
 snippets = util.readSnippets(snippetsPath);
 
-// Load static parts for the index.html file
+// Load static parts for all pages
 try {
   startPart = fs.readFileSync(path.join(staticPartsPath, 'page-start.html'), 'utf8');
   endPart = fs.readFileSync(path.join(staticPartsPath, 'page-end.html'), 'utf8');
 
   beginnerStartPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8');
   beginnerEndPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8');
+
+  indexStaticFile = fs.readFileSync(path.join(staticPartsPath, 'index.html'), 'utf8');
 } catch (err) {
   // Handle errors (hopefully not!)
   console.log(`${chalk.red('ERROR!')} During static part loading: ${err}`);
@@ -79,7 +83,67 @@ try {
 }
 // Load tag data from the database
 tagDbData = util.readTags();
-// Create the output for the index.html file
+// Create the output for the index.html file (only locally or on Travis CRON or custom job)
+if(!util.isTravisCI() || (util.isTravisCI() && (process.env['TRAVIS_EVENT_TYPE'] === 'cron' || process.env['TRAVIS_EVENT_TYPE'] === 'api'))) {
+  try {
+    // Shuffle the array of snippets, pick 3
+    let indexDailyPicks = '';
+    let shuffledSnippets = util.shuffle(Object.keys(snippets)).slice(0,3);
+    const dailyPicks =  Object.keys(snippets)
+      .filter(key => shuffledSnippets.includes(key))
+      .reduce((obj, key) => {
+        obj[key] = snippets[key];
+      return obj;
+    }, {});
+
+    // Generate the html for the picked snippets
+    for (let snippet of Object.entries(dailyPicks))
+          indexDailyPicks +=
+          '
' +
+            md
+              .render(`\n${snippets[snippet[0]]}`)
+              .replace(/
/g, `${snippet[1].includes('advanced')?'advanced':''}
`)
+              .replace(/<\/h3>/g, '

') + .replace(/
([^\0]*?)<\/code><\/pre>/gm, (match, p1) => `
${Prism.highlight(unescapeHTML(p1), Prism.languages.javascript)}
`)
+              .replace(/<\/pre>\s+
📋 Copy to clipboard' +
+            '
'; + // Select the first snippet from today's picks + indexDailyPicks = indexDailyPicks.replace('card fluid pick', 'card fluid pick selected'); + // Optimize punctuation nodes + indexDailyPicks = util.optimizeNodes(indexDailyPicks, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize operator nodes + indexDailyPicks = util.optimizeNodes(indexDailyPicks, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize keyword nodes + indexDailyPicks = util.optimizeNodes(indexDailyPicks, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Put the daily picks into the page + indexStaticFile = indexStaticFile.replace('$daily-picks',indexDailyPicks); + // Use the Github API to get the needed data + const githubApi = 'api.github.com'; + const headers = { 'User-Agent' : '30-seconds-of-code'}; + // Send requests and wait for responses, write to the page + https.get({host: githubApi, path: '/repos/chalarangelo/30-seconds-of-code/commits?per_page=1', headers: headers}, resCommits =>{ + https.get({host: githubApi, path: '/repos/chalarangelo/30-seconds-of-code/contributors?per_page=1', headers: headers}, resContributors => { + https.get({host: githubApi, path: '/repos/chalarangelo/30-seconds-of-code/stargazers?per_page=1', headers: headers}, resStars => { + let commits = resCommits.headers.link.split('&').slice(-1)[0].replace(/[^\d]/g,''), + contribs = resContributors.headers.link.split('&').slice(-1)[0].replace(/[^\d]/g,''), + stars = resStars.headers.link.split('&').slice(-1)[0].replace(/[^\d]/g,''); + indexStaticFile = indexStaticFile.replace(/\$snippet-count/g, Object.keys(snippets).length).replace(/\$commit-count/g,commits).replace(/\$contrib-count/g,contribs).replace(/\$star-count/g,stars); + // Generate 'index.html' file + fs.writeFileSync(path.join(docsPath, 'index.html'), indexStaticFile); + console.log(`${chalk.green('SUCCESS!')} index.html file generated!`); + }); + }); + }); + + } catch (err) { + console.log(`${chalk.red('ERROR!')} During index.html generation: ${err}`); + process.exit(1); + } +} + +// Create the output for individual category pages try { // Add the start static part output += `${startPart + '\n'}`; @@ -125,6 +189,7 @@ try { ''; // Add the ending static part localOutput += `\n${endPart + '\n'}`; + // Optimize punctuation nodes localOutput = util.optimizeNodes(localOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); // Optimize operator nodes localOutput = util.optimizeNodes(localOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); @@ -153,8 +218,6 @@ try { fs.writeFileSync(path.join(docsPath, page.tag+'.html'), page.content); console.log(`${chalk.green('SUCCESS!')} ${page.tag}.html file generated!`); }) - // Write to the index.html file - //fs.writeFileSync(path.join(docsPath, 'index.html'), output); } catch (err) { // Handle errors (hopefully not!) console.log(`${chalk.red('ERROR!')} During category page generation: ${err}`); @@ -162,7 +225,6 @@ try { } // Create the output for the beginner.html file - try { // Add the static part beginnerOutput += `${beginnerStartPart + '\n'}`; @@ -190,6 +252,7 @@ try { '' + ''; + // Optimize punctuation nodes beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); // Optimize operator nodes beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index 0951a27b1..8a2c37d4c 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -2,7 +2,7 @@ - 30 seconds of code - Beginner Section + Snippets for Beginners - 30 seconds of code diff --git a/static-parts/index.html b/static-parts/index.html index 00d8a3b14..d6f90e7d6 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -24,19 +24,19 @@
-

295
snippets

+

$snippet-count
snippets

-

114
contributors

+

$contrib-count
contributors

-

3028
commits

+

$commit-count
commits

-

19459
stars

+

$star-count
stars

@@ -65,16 +65,7 @@
-
-

bottomVisible

Returns true if the bottom of the page is visible, false otherwise.

Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.

const bottomVisible = () =>
-  document.documentElement.clientHeight + window.scrollY >=
-  (document.documentElement.scrollHeight || document.documentElement.clientHeight);
-
bottomVisible(); // true
-
-

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
-
const firstTwoMax = ary(Math.max, 2);
-[[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
-
+ $daily-picks
@@ -191,7 +182,7 @@ Adapter - 30 seconds of code

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.

 

Adapter

ary

Creates a function that accepts up to n arguments, ignoring any additional arguments.

Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).

const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Adapter
ary
Creates a function that accepts up to n arguments, ignoring any additional arguments.
Call the provided function, fn, with up to n arguments, using Array.slice(0,n) and the spread operator (...).
const ary = (fn, n) => (...args) => fn(...args.slice(0, n));
 
const firstTwoMax = ary(Math.max, 2);
 [[2, 6, 'a'], [8, 4, 6], [10]].map(x => firstTwoMax(...x)); // [6, 8, 10]
 
call
Given a key and a set of arguments, call them when given a context. Primarily useful in composition.
Use a closure to call a stored key with stored arguments.
const call = (key, ...args) => context => context[key](...args);
diff --git a/docs/array.html b/docs/array.html
index 2188e68ea..180357d00 100644
--- a/docs/array.html
+++ b/docs/array.html
@@ -1,4 +1,4 @@
-Array - 30 seconds of codeArray - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Array
all
Returns true if the provided predicate function returns true for all elements in a collection, false otherwise.
Use Array.every() to test if all elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.
const all = (arr, fn = Boolean) => arr.every(fn);
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Array
all
Returns true if the provided predicate function returns true for all elements in a collection, false otherwise.
Use Array.every() to test if all elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.
const all = (arr, fn = Boolean) => arr.every(fn);
 
all([4, 2, 3], x => x > 1); // true
 all([1, 2, 3]); // true
 
any
Returns true if the provided predicate function returns true for at least one element in a collection, false otherwise.
Use Array.some() to test if any elements in the collection return true based on fn. Omit the second argument, fn, to use Boolean as a default.
const any = (arr, fn = Boolean) => arr.some(fn);
diff --git a/docs/beginner.html b/docs/beginner.html
index c5618edd3..65dbc5b9e 100644
--- a/docs/beginner.html
+++ b/docs/beginner.html
@@ -1,12 +1,20 @@
 
 
   
+    
+    
+    
     
     Snippets for Beginners - 30 seconds of code
     
     
     
-    
+    
     
     
     
@@ -75,11 +83,11 @@
     
   
   
-      
+      
     

-      
logo 30 seconds of code

+      
logo 30 seconds of code

       
Curated collection of useful JavaScript snippets
 that you can understand in 30 seconds or less.

-      
+      
     

     

       

@@ -281,6 +289,7 @@ Return the string truncated to the desired length, with '...' appen
 
    

     

     
+    

     
   
-
\ No newline at end of file
+
diff --git a/docs/browser.html b/docs/browser.html
index 4252896a6..b740bcf2a 100644
--- a/docs/browser.html
+++ b/docs/browser.html
@@ -1,4 +1,4 @@
-Browser - 30 seconds of codeBrowser - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Browser
arrayToHtmlList
Converts the given array elements into <li> tags and appends them to the list of the given id.
Use Array.map() and document.querySelector() to create a list of html tags.
const arrayToHtmlList = (arr, listID) =>
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Browser
arrayToHtmlList
Converts the given array elements into <li> tags and appends them to the list of the given id.
Use Array.map() and document.querySelector() to create a list of html tags.
const arrayToHtmlList = (arr, listID) =>
   arr.map(item => (document.querySelector('#' + listID).innerHTML += `<li>${item}</li>`));
 
arrayToHtmlList(['item 1', 'item 2'], 'myListID');
 
bottomVisible
Returns true if the bottom of the page is visible, false otherwise.
Use scrollY, scrollHeight and clientHeight to determine if the bottom of the page is visible.
const bottomVisible = () =>
diff --git a/docs/date.html b/docs/date.html
index ea628afd9..83e57e775 100644
--- a/docs/date.html
+++ b/docs/date.html
@@ -1,4 +1,4 @@
-Date - 30 seconds of codeDate - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Date
formatDuration
Returns the human readable format of the given number of milliseconds.
Divide ms with the appropriate values to obtain the appropriate values for day, hour, minute, second and millisecond. Use Object.entries() with Array.filter() to keep only non-zero values. Use Array.map() to create the string for each value, pluralizing appropriately. Use String.join(', ') to combine the values into a string.
const formatDuration = ms => {
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Date
formatDuration
Returns the human readable format of the given number of milliseconds.
Divide ms with the appropriate values to obtain the appropriate values for day, hour, minute, second and millisecond. Use Object.entries() with Array.filter() to keep only non-zero values. Use Array.map() to create the string for each value, pluralizing appropriately. Use String.join(', ') to combine the values into a string.
const formatDuration = ms => {
   if (ms < 0) ms = -ms;
   const time = {
     day: Math.floor(ms / 86400000),
diff --git a/docs/function.html b/docs/function.html
index 50f9a98c7..e1335f9eb 100644
--- a/docs/function.html
+++ b/docs/function.html
@@ -1,4 +1,4 @@
-Function - 30 seconds of codeFunction - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Function
attempt
Attempts to invoke a function with the provided arguments, returning either the result or the caught error object.
Use a try... catch block to return either the result of the function or an appropriate error.
const attempt = (fn, ...args) => {
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Function
attempt
Attempts to invoke a function with the provided arguments, returning either the result or the caught error object.
Use a try... catch block to return either the result of the function or an appropriate error.
const attempt = (fn, ...args) => {
   try {
     return fn(...args);
   } catch (e) {
diff --git a/docs/index.html b/docs/index.html
index 936e77ecc..e4fe50ffb 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,6 +1,14 @@
 
 
   
+    
+    
+    
     
     30 seconds of code
     
@@ -14,10 +22,11 @@
     
   
   
+    
     

   
logo 30 seconds of code

   
Curated collection of useful JavaScript snippets
 that you can understand in 30 seconds or less.

-  
+  
 

 

   

@@ -36,7 +45,7 @@
       

       

         
-        
19461
stars

+        
19462
stars

       

     

   

@@ -62,47 +71,60 @@
   

     

       
Today's picks

+      
Our sophisticated robot helpers pick new snippets from our collection daily, so that you can discover new snippets to enhance your projects:

       

         
       
-      
palindrome

-
Returns true if the given string is a palindrome, false otherwise.

-
Convert string String.toLowerCase() and use String.replace() to remove non-alphanumeric characters from it.
-Then, String.split('') into individual characters, Array.reverse(), String.join('') and compare to the original, unreversed string, after converting it String.tolowerCase().

-
const palindrome = str => {
-  const s = str.toLowerCase().replace(/[\W_]/g, '');
-  return (
-    s ===
-    s
-      .split('')
-      .reverse()
-      .join('')
-  );
-};
-
palindrome('taco cat'); // true
+      
RGBToHex

+
Converts the values of RGB components to a color code.

+
Convert given RGB parameters to hexadecimal string using bitwise left-shift operator (<<) and toString(16), then String.padStart(6,'0') to get a 6-digit hexadecimal value.

+
const RGBToHex = (r, g, b) => ((r << 16) + (g << 8) + b).toString(16).padStart(6, '0');
+
RGBToHex(255, 165, 1); // 'ffa501'
 

-
sampleSize

-
Gets n random elements at unique keys from array up to the size of array.

-
Shuffle the array using the Fisher-Yates algorithm.
-Use Array.slice() to get the first n elements.
-Omit the second argument, n to get only one element at random from the array.

-
const sampleSize = ([...arr], n = 1) => {
-  let m = arr.length;
-  while (m) {
-    const i = Math.floor(Math.random() * m--);
-    [arr[m], arr[i]] = [arr[i], arr[m]];
-  }
-  return arr.slice(0, n);
+
throttle

+
Creates a throttled function that only invokes the provided function at most once per every wait milliseconds

+
Use setTimeout() and clearTimeout() to throttle the given method, fn.
+Use Function.apply() to apply the this context to the function and provide the necessary arguments.
+Use Date.now() to keep track of the last time the throttled function was invoked.
+Omit the second argument, wait, to set the timeout at a default of 0 ms.

+
const throttle = (fn, wait) => {
+  let inThrottle, lastFn, lastTime;
+  return function() {
+    const context = this,
+      args = arguments;
+    if (!inThrottle) {
+      fn.apply(context, args);
+      lastTime = Date.now();
+      inThrottle = true;
+    } else {
+      clearTimeout(lastFn);
+      lastFn = setTimeout(function() {
+        if (Date.now() - lastTime >= wait) {
+          fn.apply(context, args);
+          lastTime = Date.now();
+        }
+      }, wait - (Date.now() - lastTime));
+    }
+  };
 };
-
sampleSize([1, 2, 3], 2); // [3,1]
-sampleSize([1, 2, 3], 4); // [2,3,1]
+
window.addEventListener(
+  'resize',
+  throttle(function(evt) {
+    console.log(window.innerWidth);
+    console.log(window.innerHeight);
+  }, 250)
+); // Will log the window dimensions at most every 250ms
 

-
spreadOver

-
Takes a variadic function and returns a closure that accepts an array of arguments to map to the inputs of the function.

-
Use closures and the spread operator (...) to map the array of arguments to the inputs of the function.

-
const spreadOver = fn => argsArr => fn(...argsArr);
-
const arrayMax = spreadOver(Math.max);
-arrayMax([1, 2, 3]); // 3
+
toCurrency

+
Take a number and return specified currency formatting.

+
Use Intl.NumberFormat to enable country / currency sensitive formatting.

+
const toCurrency = (n, curr, LanguageFormat = undefined) =>
+  Intl.NumberFormat(LanguageFormat, { style: 'currency', currency: curr }).format(n);
+
toCurrency(123456.789, 'EUR'); // €123,456.79  | currency: Euro | currencyLangFormat: Local
+toCurrency(123456.789, 'USD', 'en-us'); // $123,456.79  | currency: US Dollar | currencyLangFormat: English (United States)
+toCurrency(123456.789, 'USD', 'fa'); // ۱۲۳٬۴۵۶٫۷۹ ؜$ | currency: US Dollar | currencyLangFormat: Farsi
+toCurrency(322342436423.2435, 'JPY'); // ¥322,342,436,423 | currency: Japanese Yen | currencyLangFormat: Local
+toCurrency(322342436423.2435, 'JPY', 'fi'); // 322 342 436 423 ¥ | currency: Japanese Yen | currencyLangFormat: Finnish
 

 

       

@@ -115,10 +137,10 @@ Omit the second argument, n to get only one element at random from
     

       
Getting started

       

     

   

@@ -221,7 +243,7 @@ Omit the second argument, n to get only one element at random from
 Math - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Math
approximatelyEqual
Checks if two numbers are approximately equal to each other.
Use Math.abs() to compare the absolute difference of the two values to epsilon. Omit the third parameter, epsilon, to use a default value of 0.001.
const approximatelyEqual = (v1, v2, epsilon = 0.001) => Math.abs(v1 - v2) < epsilon;
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Math
approximatelyEqual
Checks if two numbers are approximately equal to each other.
Use Math.abs() to compare the absolute difference of the two values to epsilon. Omit the third parameter, epsilon, to use a default value of 0.001.
const approximatelyEqual = (v1, v2, epsilon = 0.001) => Math.abs(v1 - v2) < epsilon;
 
approximatelyEqual(Math.PI / 2.0, 1.5708); // true
 
average
Returns the average of two or more numbers.
Use Array.reduce() to add each value to an accumulator, initialized with a value of 0, divide by the length of the array.
const average = (...nums) => [...nums].reduce((acc, val) => acc + val, 0) / nums.length;
 
average(...[1, 2, 3]); // 2
diff --git a/docs/mini.css b/docs/mini.css
index 0f4cccbf9..2ee8661ae 100644
--- a/docs/mini.css
+++ b/docs/mini.css
@@ -1 +1 @@
-:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a—  " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s}header h1.logo a{text-decoration:none;color:#111}@media screen and (min-width: 769px){header h1.logo:hover{top:-3.5rem}}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff}body{overflow-x:hidden}
+:root{--f-col:#111;--f-col2:#444;--b-col:#f8f8f8;--b-col2:#f0f0f0;--blq-col:#f57c00;--pre-col:#1565c0;--br-col:#aaa;--br-col2:#ddd;--h-ratio:1.19;--u-m:.5rem;--u-p:.5rem;--u-br-r:.125rem;--a-l-col:#0277bd;--a-v-col:#01579b}html{font-size:16px}a,b,del,em,i,ins,q,span,strong,u{font-size:1em}html,*{font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", Helvetica, sans-serif;line-height:1.5;-webkit-text-size-adjust:100%}*{font-size:1rem}body{margin:0;color:var(--f-col);background:var(--b-col)}details{display:block}summary{display:list-item}abbr[title]{border-bottom:none;text-decoration:underline dotted}input{overflow:visible}img{max-width:100%;height:auto}h1,h2,h3,h4,h5,h6{line-height:1.2;margin:calc(1.5 * var(--u-m)) var(--u-m);font-weight:500}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{color:var(--f-col2);display:block;margin-top:-.25rem}h1{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h2{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio) * var(--h-ratio))}h3{font-size:calc(1rem * var(--h-ratio) * var(--h-ratio))}h4{font-size:calc(1rem * var(--h-ratio))}h5{font-size:1rem}h6{font-size:calc(1rem / var(--h-ratio))}p{margin:var(--u-m)}ol,ul{margin:var(--u-m);padding-left:calc(2 * var(--u-m))}b,strong{font-weight:700}hr{box-sizing:content-box;border:0;line-height:1.25em;margin:var(--u-m);height:.0625rem;background:linear-gradient(to right, transparent, var(--br-col) 20%, var(--br-col) 80%, transparent)}blockquote{display:block;position:relative;font-style:italic;color:var(--f-col2);margin:var(--u-m);padding:calc(3 * var(--u-p));border:.0625rem solid var(--br-col2);border-left:.375rem solid var(--blq-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}blockquote:before{position:absolute;top:calc(0rem - var(--u-p));left:0;font-family:sans-serif;font-size:3rem;font-weight:700;content:"\201c";color:var(--blq-col)}blockquote[cite]:after{font-style:normal;font-size:.75em;font-weight:700;content:"\a—  " attr(cite);white-space:pre}code,kbd,pre,samp{font-family:Menlo, Consolas, monospace;font-size:.85em}code{background:var(--b-col2);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}kbd{background:var(--f-col);color:var(--b-col);border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}pre{overflow:auto;background:var(--b-col2);padding:calc(1.5 * var(--u-p));margin:var(--u-m);border:.0625rem solid var(--br-col2);border-left:.25rem solid var(--pre-col);border-radius:0 var(--u-br-r) var(--u-br-r) 0}sup,sub,code,kbd{line-height:0;position:relative;vertical-align:baseline}small,sup,sub,figcaption{font-size:.75em}sup{top:-.5em}sub{bottom:-.25em}figure{margin:var(--u-m)}figcaption{color:var(--f-col2)}a{text-decoration:none}a:link{color:var(--a-l-col)}a:visited{color:var(--a-v-col)}a:hover,a:focus{text-decoration:underline}.container{margin:0 auto;padding:0 calc(1.5 * var(--u-p))}.row{box-sizing:border-box;display:flex;flex:0 1 auto;flex-flow:row wrap}.col-sm,[class^='col-sm-'],[class^='col-sm-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-sm{max-width:100%;flex-grow:1;flex-basis:0}.col-sm-1{max-width:8.33333%;flex-basis:8.33333%}.col-sm-o-0{margin-left:0}.col-sm-2{max-width:16.66667%;flex-basis:16.66667%}.col-sm-o-1{margin-left:8.33333%}.col-sm-3{max-width:25%;flex-basis:25%}.col-sm-o-2{margin-left:16.66667%}.col-sm-4{max-width:33.33333%;flex-basis:33.33333%}.col-sm-o-3{margin-left:25%}.col-sm-5{max-width:41.66667%;flex-basis:41.66667%}.col-sm-o-4{margin-left:33.33333%}.col-sm-6{max-width:50%;flex-basis:50%}.col-sm-o-5{margin-left:41.66667%}.col-sm-7{max-width:58.33333%;flex-basis:58.33333%}.col-sm-o-6{margin-left:50%}.col-sm-8{max-width:66.66667%;flex-basis:66.66667%}.col-sm-o-7{margin-left:58.33333%}.col-sm-9{max-width:75%;flex-basis:75%}.col-sm-o-8{margin-left:66.66667%}.col-sm-10{max-width:83.33333%;flex-basis:83.33333%}.col-sm-o-9{margin-left:75%}.col-sm-11{max-width:91.66667%;flex-basis:91.66667%}.col-sm-o-10{margin-left:83.33333%}.col-sm-12{max-width:100%;flex-basis:100%}.col-sm-o-11{margin-left:91.66667%}.col-sm-n{order:initial}.col-sm-f{order:-999}.col-sm-l{order:999}@media screen and (min-width: 768px){.col-md,[class^='col-md-'],[class^='col-md-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-md{max-width:100%;flex-grow:1;flex-basis:0}.col-md-1{max-width:8.33333%;flex-basis:8.33333%}.col-md-o-0{margin-left:0}.col-md-2{max-width:16.66667%;flex-basis:16.66667%}.col-md-o-1{margin-left:8.33333%}.col-md-3{max-width:25%;flex-basis:25%}.col-md-o-2{margin-left:16.66667%}.col-md-4{max-width:33.33333%;flex-basis:33.33333%}.col-md-o-3{margin-left:25%}.col-md-5{max-width:41.66667%;flex-basis:41.66667%}.col-md-o-4{margin-left:33.33333%}.col-md-6{max-width:50%;flex-basis:50%}.col-md-o-5{margin-left:41.66667%}.col-md-7{max-width:58.33333%;flex-basis:58.33333%}.col-md-o-6{margin-left:50%}.col-md-8{max-width:66.66667%;flex-basis:66.66667%}.col-md-o-7{margin-left:58.33333%}.col-md-9{max-width:75%;flex-basis:75%}.col-md-o-8{margin-left:66.66667%}.col-md-10{max-width:83.33333%;flex-basis:83.33333%}.col-md-o-9{margin-left:75%}.col-md-11{max-width:91.66667%;flex-basis:91.66667%}.col-md-o-10{margin-left:83.33333%}.col-md-12{max-width:100%;flex-basis:100%}.col-md-o-11{margin-left:91.66667%}.col-md-n{order:initial}.col-md-f{order:-999}.col-md-l{order:999}}@media screen and (min-width: 1280px){.col-lg,[class^='col-lg-'],[class^='col-lg-o-']{flex:0 0 auto;padding:0 calc(var(--u-p) / 2)}.col-lg{max-width:100%;flex-grow:1;flex-basis:0}.col-lg-1{max-width:8.33333%;flex-basis:8.33333%}.col-lg-o-0{margin-left:0}.col-lg-2{max-width:16.66667%;flex-basis:16.66667%}.col-lg-o-1{margin-left:8.33333%}.col-lg-3{max-width:25%;flex-basis:25%}.col-lg-o-2{margin-left:16.66667%}.col-lg-4{max-width:33.33333%;flex-basis:33.33333%}.col-lg-o-3{margin-left:25%}.col-lg-5{max-width:41.66667%;flex-basis:41.66667%}.col-lg-o-4{margin-left:33.33333%}.col-lg-6{max-width:50%;flex-basis:50%}.col-lg-o-5{margin-left:41.66667%}.col-lg-7{max-width:58.33333%;flex-basis:58.33333%}.col-lg-o-6{margin-left:50%}.col-lg-8{max-width:66.66667%;flex-basis:66.66667%}.col-lg-o-7{margin-left:58.33333%}.col-lg-9{max-width:75%;flex-basis:75%}.col-lg-o-8{margin-left:66.66667%}.col-lg-10{max-width:83.33333%;flex-basis:83.33333%}.col-lg-o-9{margin-left:75%}.col-lg-11{max-width:91.66667%;flex-basis:91.66667%}.col-lg-o-10{margin-left:83.33333%}.col-lg-12{max-width:100%;flex-basis:100%}.col-lg-o-11{margin-left:91.66667%}.col-lg-n{order:initial}.col-lg-f{order:-999}.col-lg-l{order:999}}:root{--cd-b-col:#f8f8f8;--cd-f-col:#111;--cd-br-col:#ddd}.card{display:flex;flex-direction:column;justify-content:space-between;align-self:center;position:relative;width:100%;background:var(--cd-b-col);color:var(--cd-f-col);border:.0625rem solid var(--cd-br-col);border-radius:var(--u-br-r);margin:var(--u-m);overflow:hidden}@media screen and (min-width: 320px){.card{max-width:320px}}.card>.section{background:var(--cd-b-col);color:var(--cd-f-col);box-sizing:border-box;margin:0;border:0;border-radius:0;border-bottom:.0625rem solid var(--cd-br-col);padding:var(--u-p);width:100%}.card>.section.media{height:200px;padding:0;-o-object-fit:cover;object-fit:cover}.card>.section:last-child{border-bottom:0}.card.fluid{max-width:100%;width:auto}.card>.section.double-padded{padding:calc(1.5 * var(--u-p))}.card{box-shadow:0 1.25rem 2.5rem -0.625rem rgba(0,32,64,0.1)}.card>h3.section.double-padded{padding:calc(3 * var(--u-p))}.card>.section.double-padded>p{margin:var(--u-m) calc(var(--u-m) / 2)}.card+.card{margin-top:calc(5 * var(--u-m))}:root{--frm-b-col:#f0f0f0;--frm-f-col:#111;--frm-br-col:#ddd;--in-b-col:#f8f8f8;--in-f-col:#111;--in-br-col:#ddd;--in-fc-col:#0288d1;--in-inv-col:#d32f2f;--btn-b-col:#e2e2e2;--btn-h-b-col:#dcdcdc;--btn-f-col:#212121;--btn-br-col:transparent;--btn-h-br-col:transparent;--btn-grp-br-col:rgba(124,124,124,0.54)}form{background:var(--frm-b-col);color:var(--frm-f-col);border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:var(--u-m);padding:calc(2 * var(--u-p)) var(--u-p)}fieldset{border:.0625rem solid var(--frm-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 4);padding:var(--u-p)}legend{box-sizing:border-box;display:table;max-width:100%;white-space:normal;font-weight:700;padding:calc(var(--u-p) / 2)}label{padding:calc(var(--u-p) / 2) var(--u-p)}.input-group{display:inline-block}.input-group.fluid{display:flex;align-items:center;justify-content:center}.input-group.fluid>input{max-width:100%;flex-grow:1;flex-basis:0px}@media screen and (max-width: 767px){.input-group.fluid{align-items:stretch;flex-direction:column}}.input-group.vertical{display:flex;align-items:stretch;flex-direction:column}.input-group.vertical>input{max-width:100%;flex-grow:1;flex-basis:0px}[type="number"]::-webkit-inner-spin-button,[type="number"]::-webkit-outer-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}[type="search"]::-webkit-search-cancel-button,[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input:not([type]),[type="text"],[type="email"],[type="number"],[type="search"],[type="password"],[type="url"],[type="tel"],[type="checkbox"],[type="radio"],textarea,select{box-sizing:border-box;background:var(--in-b-col);color:var(--in-f-col);border:.0625rem solid var(--in-br-col);border-radius:var(--u-br-r);margin:calc(var(--u-m) / 2);padding:var(--u-p) calc(1.5 * var(--u-p))}input:not([type="button"]):not([type="submit"]):not([type="reset"]):hover,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus,textarea:hover,textarea:focus,select:hover,select:focus{border-color:var(--in-fc-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"]):invalid,input:not([type="button"]):not([type="submit"]):not([type="reset"]):focus:invalid,textarea:invalid,textarea:focus:invalid,select:invalid,select:focus:invalid{border-color:var(--in-inv-col);box-shadow:none}input:not([type="button"]):not([type="submit"]):not([type="reset"])[readonly],textarea[readonly],select[readonly]{background:var(--b-col2)}select{max-width:100%}option{overflow:hidden;text-overflow:ellipsis}[type="checkbox"],[type="radio"]{-webkit-appearance:none;-moz-appearance:none;appearance:none;position:relative;height:calc(1rem + var(--u-p) / 2);width:calc(1rem + var(--u-p) / 2);vertical-align:text-bottom;padding:0;flex-basis:calc(1rem + var(--u-p) / 2) !important;flex-grow:0 !important}[type="checkbox"]:checked:before,[type="radio"]:checked:before{position:absolute}[type="checkbox"]:checked:before{content:'\2713';font-family:sans-serif;font-size:calc(1rem + var(--u-p) / 2);top:calc(0rem - var(--u-p));left:calc(var(--u-p) / 4)}[type="radio"]{border-radius:100%}[type="radio"]:checked:before{border-radius:100%;content:'';top:calc(.0625rem + var(--u-p) / 2);left:calc(.0625rem + var(--u-p) / 2);background:var(--in-f-col);width:0.5rem;height:0.5rem}:placeholder-shown{color:var(--in-f-col)}::-ms-placeholder{color:var(--in-f-col);opacity:0.54}button::-moz-focus-inner,[type="button"]::-moz-focus-inner,[type="reset"]::-moz-focus-inner,[type="submit"]::-moz-focus-inner{border-style:none;padding:0}button,html [type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button{overflow:visible;text-transform:none}button,[type="button"],[type="submit"],[type="reset"],a.button,label.button,.button,a[role="button"],label[role="button"],[role="button"]{display:inline-block;background:var(--btn-b-col);color:var(--btn-f-col);border:.0625rem solid var(--btn-br-col);border-radius:var(--u-br-r);padding:var(--u-p) calc(1.5 * var(--u-p));margin:var(--u-m);text-decoration:none;cursor:pointer;transition:background 0.3s}button:hover,button:focus,[type="button"]:hover,[type="button"]:focus,[type="submit"]:hover,[type="submit"]:focus,[type="reset"]:hover,[type="reset"]:focus,a.button:hover,a.button:focus,label.button:hover,label.button:focus,.button:hover,.button:focus,a[role="button"]:hover,a[role="button"]:focus,label[role="button"]:hover,label[role="button"]:focus,[role="button"]:hover,[role="button"]:focus{background:var(--btn-h-b-col);border-color:var(--btn-h-br-col)}input:disabled,input[disabled],textarea:disabled,textarea[disabled],select:disabled,select[disabled],button:disabled,button[disabled],.button:disabled,.button[disabled],[role="button"]:disabled,[role="button"][disabled]{cursor:not-allowed;opacity:.75}.button-group{display:flex;border:.0625rem solid var(--btn-grp-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}.button-group>button,.button-group [type="button"],.button-group>[type="submit"],.button-group>[type="reset"],.button-group>.button,.button-group>[role="button"]{margin:0;max-width:100%;flex:1 1 auto;text-align:center;border:0;border-radius:0;box-shadow:none}.button-group>:not(:first-child){border-left:.0625rem solid var(--btn-grp-br-col)}@media screen and (max-width: 767px){.button-group{flex-direction:column}.button-group>:not(:first-child){border:0;border-top:.0625rem solid var(--btn-grp-br-col)}}button.primary,[type="button"].primary,[type="submit"].primary,[type="reset"].primary,.button.primary,[role="button"].primary{--btn-b-col:#1976d2;--btn-f-col:#f8f8f8}button.primary:hover,button.primary:focus,[type="button"].primary:hover,[type="button"].primary:focus,[type="submit"].primary:hover,[type="submit"].primary:focus,[type="reset"].primary:hover,[type="reset"].primary:focus,.button.primary:hover,.button.primary:focus,[role="button"].primary:hover,[role="button"].primary:focus{--btn-h-b-col:#1565c0}:root{--hd-b-col:#f8f8f8;--hd-hv-b-col:#f0f0f0;--hd-f-col:#444;--hd-br-col:#ddd;--nv-b-col:#f8f8f8;--nv-hv-b-col:#f0f0f0;--nv-f-col:#444;--nv-br-col:#ddd;--nv-ln-col:#0277bd;--ft-f-col:#444;--ft-b-col:#f8f8f8;--ft-br-col:#ddd;--ft-ln-col:#0277bd;--dr-b-col:#f8f8f8;--dr-hv-b-col:#f0f0f0;--dr-br-col:#ddd;--dr-cl-col:#444}header{height:3.1875rem;background:var(--hd-b-col);color:var(--hd-f-col);border-bottom:.0625rem solid var(--hd-br-col);padding:calc(var(--u-p) / 4) 0;white-space:nowrap;overflow-x:auto;overflow-y:hidden}header.row{box-sizing:content-box}header .logo{color:var(--hd-f-col);font-size:1.75rem;padding:var(--u-p) calc(2 * var(--u-p));text-decoration:none}header button,header [type="button"],header .button,header [role="button"]{box-sizing:border-box;position:relative;top:calc(0rem - var(--u-p) / 4);height:calc(3.1875rem + var(--u-p) / 2);background:var(--hd-b-col);line-height:calc(3.1875rem - var(--u-p) * 1.5);text-align:center;color:var(--hd-f-col);border:0;border-radius:0;margin:0;text-transform:uppercase}header button:hover,header button:focus,header [type="button"]:hover,header [type="button"]:focus,header .button:hover,header .button:focus,header [role="button"]:hover,header [role="button"]:focus{background:var(--hd-hv-b-col)}nav{background:var(--nv-b-col);color:var(--nv-f-col);border:.0625rem solid var(--nv-br-col);border-radius:var(--u-br-r);margin:var(--u-m)}nav *{padding:var(--u-p) calc(1.5 * var(--u-p))}nav a,nav a:visited{display:block;color:var(--nv-ln-col);border-radius:var(--u-br-r);transition:background 0.3s}nav a:hover,nav a:focus,nav a:visited:hover,nav a:visited:focus{text-decoration:none;background:var(--nv-hv-b-col)}nav .sublink-1{position:relative;margin-left:calc(2 * var(--u-p))}nav .sublink-1:before{position:absolute;left:calc(var(--u-p) - 1 * var(--u-p));top:-.0625rem;content:'';height:100%;border:.0625rem solid var(--nv-br-col);border-left:0}footer{background:var(--ft-b-col);color:var(--ft-f-col);border-top:.0625rem solid var(--ft-br-col);padding:calc(2 * var(--u-p)) var(--u-p);font-size:.875rem}footer a,footer a:visited{color:var(--ft-ln-col)}header.sticky{position:-webkit-sticky;position:sticky;z-index:1101;top:0}footer.sticky{position:-webkit-sticky;position:sticky;z-index:1101;bottom:0}.drawer-toggle:before{display:inline-block;position:relative;vertical-align:bottom;content:'\00a0\2261\00a0';font-family:sans-serif;font-size:1.5em}@media screen and (min-width: 768px){.drawer-toggle:not(.persistent){display:none}}[type="checkbox"].drawer{height:1px;width:1px;margin:-1px;overflow:hidden;position:absolute;clip:rect(0 0 0 0);-webkit-clip-path:inset(100%);clip-path:inset(100%)}[type="checkbox"].drawer+*{display:block;box-sizing:border-box;position:fixed;top:0;width:320px;height:100vh;overflow-y:auto;background:var(--dr-b-col);border:.0625rem solid var(--dr-br-col);border-radius:0;margin:0;z-index:1110;left:-320px;transition:left 0.3s}[type="checkbox"].drawer+* .drawer-close{position:absolute;top:var(--u-m);right:var(--u-m);z-index:1111;width:2rem;height:2rem;border-radius:var(--u-br-r);padding:var(--u-p);margin:0;cursor:pointer;transition:background 0.3s}[type="checkbox"].drawer+* .drawer-close:before{display:block;content:'\00D7';color:var(--dr-cl-col);position:relative;font-family:sans-serif;font-size:2rem;line-height:1;text-align:center}[type="checkbox"].drawer+* .drawer-close:hover,[type="checkbox"].drawer+* .drawer-close:focus{background:var(--dr-hv-b-col)}@media screen and (max-width: 320px){[type="checkbox"].drawer+*{width:100%}}[type="checkbox"].drawer:checked+*{left:0}@media screen and (min-width: 768px){[type="checkbox"].drawer:not(.persistent)+*{position:static;height:100%;z-index:1100}[type="checkbox"].drawer:not(.persistent)+* .drawer-close{display:none}}:root{--mrk-b-col:#424242;--mrk-f-col:#fafafa}mark{background:var(--mrk-b-col);color:var(--mrk-f-col);font-size:.5em;line-height:1em;border-radius:var(--u-br-r);padding:calc(var(--u-p) / 4) calc(var(--u-p) / 2)}mark.inline-block{display:inline-block;font-size:1em;line-height:1.5;padding:calc(var(--u-p) / 2) var(--u-p)}:root{--tst-b-col:#212121;--tst-f-col:#fafafa}.toast{position:fixed;bottom:calc(var(--u-m) * 3);left:50%;transform:translate(-50%, -50%);z-index:1111;color:var(--tst-f-col);background:var(--tst-b-col);border-radius:calc(var(--u-br-r) * 16);padding:var(--u-p) calc(var(--u-p) * 3)}div,main,nav{-webkit-overflow-scrolling:touch}.toast{bottom:calc(var(--u-m) / 2);opacity:1;transition:opacity 0.3s ease-in-out}mark{position:relative;top:-0.25rem;left:0.25rem}mark.secondary{--mrk-b-col:#d32f2f}mark.tertiary{--mrk-b-col:#308732}mark.tag{padding:calc(var(--u-p)/2) var(--u-p);border-radius:1em}code,pre,kbd,code *,pre *,kbd *,code[class*="language-"],pre[class*="language-"]{font-family:Menlo, Consolas, monospace !important}pre{border:0.0625rem solid var(--br-col2);border-radius:var(--u-br-r)}.search{font-size:0.875rem}header h1.logo{margin-top:-0.8rem;text-align:center;position:relative;top:0;transition:top 0.3s;color:#111}h1 a,h1 a:link,h1 a:visited{text-decoration:none;color:#111}h1 a:hover,h1 a:focus,h1 a:link:hover,h1 a:link:focus,h1 a:visited:hover,h1 a:visited:focus{text-decoration:none;color:#111}header #title{position:relative;top:-1rem}@media screen and (max-width: 768px){header #title{display:none}}header{background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}header h1 small{display:block;font-size:0.875rem;color:#888;margin-top:0.75rem}label#menu-toggle{position:absolute;left:0rem;top:0rem;width:3.4375rem}main{padding:0}:root{--clps-lbl-b-col:#e8e8e8;--clps-lbl-f-col:#212121;--clps-lbl-h-b-col:#f0f0f0;--clps-sel-lbl-b-col:#ececec;--clps-br-col:#ddd;--clps-cnt-b-col:#fafafa;--clps-sel-lbl-br-col:#0277bd}label.collapse{width:100%;display:inline-block;cursor:pointer;box-sizing:border-box;transition:background 0.3s;color:var(--clps-lbl-f-col);background:var(--clps-lbl-b-col);border:.0625rem solid var(--clps-br-col);padding:calc(1.5 * var(--u-p));border-radius:var(--u-br-r)}label.collapse:hover,label.collapse:focus{background:var(--clps-lbl-h-b-col)}label.collapse+pre{box-sizing:border-box;height:0;max-height:1px;overflow:auto;margin:0;border:0;padding:0;transition:max-height 0.3s}label.collapse.toggled{background:var(--clps-sel-lbl-b-col);border-bottom-color:var(--clps-sel-lbl-br-col);border-bottom-left-radius:0;border-bottom-right-radius:0}label.collapse.toggled+pre{border-top-left-radius:0;border-top-right-radius:0;position:relative;width:100%;height:auto;border:.0625rem solid var(--clps-br-col);border-top:0;padding:calc(2 * var(--u-p));max-height:400px}button.primary.clipboard-copy{width:100%;margin-left:0}button.primary.clipboard-copy>img{vertical-align:bottom}code[class*="language-"],pre[class*="language-"]{color:#222;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.8;-moz-tab-size:2;-o-tab-size:2;tab-size:2;-webkit-hypens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*="language-"]{padding:calc(2 * var(--u-p));overflow:auto;margin:var(--u-m) 0}pre[class*="language-"]::-moz-selection,pre[class*="language-"] ::-moz-selection,code[class*="language-"]::-moz-selection,code[class*="language-"] ::-moz-selection{background:#b3d4fc}pre[class*="language-"]::selection,pre[class*="language-"] ::selection,code[class*="language-"]::selection,code[class*="language-"] ::selection{background:#b3d4fc}:not(pre)>code[class*="language-"]{padding:.1em;border-radius:.3em;white-space:normal}.token.comment,.token.prolog,.token.doctype,.token.cdata{color:#7a8490}.token.punctuation{color:#666}.namespace{opacity:.7}.token.property,.token.tag,.token.boolean,.token.constant,.token.symbol,.token.deleted,.token.function{color:#005cc5}.token.number,.token.class-name{color:#832ed2}.token.selector,.token.attr-name,.token.string,.token.char,.token.builtin,.token.inserted{color:#067e36}.token.operator,.token.entity,.token.url,.language-css .token.string,.style .token.string,.token.atrule,.token.attr-value,.token.keyword{color:#d73a49}.token.regex{color:#097cab}.token.important,.token.variable{color:#e90}.token.important,.token.bold{font-weight:bold}.token.italic{font-style:italic}.token.entity{cursor:help}button.scroll-to-top{border-radius:100%;font-size:1.5rem;line-height:1;box-sizing:border-box;width:2.75rem;height:2.75rem;position:fixed;bottom:1rem;right:2rem;background:var(--b-col);box-shadow:0 0.25rem 0.25rem 0 rgba(0,0,0,0.125),0 0.125rem 0.125rem -0.125rem rgba(0,0,0,0.25)}button.scroll-to-top:hover,button.scroll-to-top:focus{background:var(--b-col2)}.card#disclaimer{position:fixed;bottom:0;z-index:1100;max-width:100vw;width:100vw;left:0;text-align:center;font-size:1.5rem;margin:0}@media screen and (min-width: 768px){.card#disclaimer{width:60vw;left:20vw;bottom:1rem}}@media screen and (min-width: 1280px){.card#disclaimer{width:40vw;left:30vw;bottom:1.5rem}}button#disclaimer-close{position:absolute;top:-0.5rem;right:-0.5rem;font-size:0.85rem;background:0}#splash{height:auto;padding-bottom:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%)}#splash #logo{margin-top:0;margin-left:-0.5rem;padding-top:2rem;text-align:center;font-size:2.25rem;line-height:2}#splash #logo img{vertical-align:top;height:4.5rem}#splash #tagline{text-align:center;padding:0.5rem 25%}#splash #doc-link{text-align:center;margin-left:-0.5rem}#splash #doc-link>a{background:transparent;border:0.0625rem solid rgba(17,17,17,0.95);transition:all 0.3s}#splash #doc-link>a:hover,#splash #doc-link>a:focus{background:rgba(17,17,17,0.95);color:#e86957}@media screen and (max-width: 767px){#splash #logo{font-size:1.75rem}#splash #logo img{height:3.5rem}#splash #tagline{padding:0.25rem 17.5%;font-size:0.875rem}#splash #doc-link{font-size:0.875rem}}@media screen and (max-width: 383px){#splash #logo{font-size:1.5rem}#splash #logo img{height:3rem}#splash #tagline{padding:0.125rem 5%}}@media screen and (max-width: 479px){#splash #tagline #tagline-lg{display:none}}@media screen and (min-width: 768px){.col-md-offset-1{margin-left:8.33333%}}@media screen and (min-width: 1280px){.col-lg-offset-2{margin-left:16.66667%}}h2.index-section{border-left:0.3125rem solid #de4a6d;padding-left:0.625rem;margin-top:2rem}#license-icon{text-align:center}@media screen and (min-width: 768px){#license-icon{position:relative;top:calc(50% - 40px)}}#license-icon>svg{border:0.03125rem solid #444;border-radius:100%;padding:0.5rem;fill:#444}#license{vertical-align:middle}.no-padding{padding:0}#in-numbers{background:#111;padding-top:0.75rem;padding-bottom:0.75rem;color:#fff}#in-numbers svg{fill:#fff}@media screen and (min-width: 768px){#in-numbers svg{position:relative;top:20px;left:-34px;width:32px;height:32px}}#in-numbers p{overflow-wrap:break-word;margin-top:0;font-size:0.625rem;margin-bottom:0}@media screen and (min-width: 768px){#in-numbers p{position:relative;top:-24px;left:22px;font-size:0.75rem}}#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1rem}@media screen and (min-width: 768px){#snippet-count,#contrib-count,#commit-count,#star-count{font-size:1.25rem}}ul#links{list-style:none;padding-left:0}ul#links li+li{padding-top:0.625rem}.pick:not(.selected){display:none}.card.pick{transition:all 0.6s;left:0}.card.pick+.card.pick{margin-top:0.5rem}.pick.selected{overflow:visible}.pick.selected button.next{position:absolute;top:50%;right:-1rem}.pick.selected button.next>svg{margin-right:-0.0625rem}#pick-slider{position:relative}button.previous{left:-1%}button.previous>svg{margin-left:-0.125rem}button.next{right:-1%}button.next>svg{margin-left:0.0625rem}button.previous,button.next{position:absolute;top:50%;border-radius:100%;background:#f8f8f8;border:0.03125rem solid #ddd;width:1.5rem;height:1.5rem;padding:0;margin:0;transition:all 0.3s;z-index:2000}button.previous>svg,button.next>svg{fill:#888;transition:all 0.3s}button.previous:hover,button.previous:focus,button.next:hover,button.next:focus{border-color:#aaa}button.previous:hover>svg,button.previous:focus>svg,button.next:hover>svg,button.next:focus>svg{fill:#444}.card.contributor{height:calc(100% - 1rem);justify-content:left}.card.contributor>.section.media{height:auto}.card.contributor>.section.button{font-size:0.75rem;font-weight:700;text-align:center;transition:color 0.3s}.card.contributor>.section.button:hover,.card.contributor>.section.button:focus{color:var(--a-l-col);background:#f8f8f8}.card.fluid.contribution-guideline{overflow:visible;margin-top:3rem;padding-bottom:0.25rem}.card.fluid.contribution-guideline h3{padding-top:0.5rem;text-align:center}.contribution-guideline+.contribution-guideline:before,.contribution-guideline+.contribution-guideline:after{content:"";position:relative;top:-2.75rem;width:0.375rem;height:0.375rem;background:#ddd;border:0.03125rem solid #d0d0d0;border-radius:100%;left:calc(50% - 0.1875rem);box-shadow:inset -0.03125rem -0.03125rem 0.03125rem rgba(0,0,0,0.05)}.contribution-guideline+.contribution-guideline:after{position:absolute;top:-1.875rem}.contribution-number{position:absolute;top:-1.125rem;left:calc(50% - 1.125rem);font-size:1.5rem;background:linear-gradient(135deg, #ffae27 0%, #de496d 100%);border:0.03125 solid #ddd;width:2.25rem;text-align:center;height:2.25rem;border-radius:100%;font-weight:700;color:#fff}body{overflow-x:hidden}
diff --git a/docs/mini/flavor.scss b/docs/mini/flavor.scss
index a0c5eed5e..3ce1226bb 100644
--- a/docs/mini/flavor.scss
+++ b/docs/mini/flavor.scss
@@ -209,14 +209,15 @@ header h1.logo {
   position: relative;
   top: 0;
   transition: top 0.3s;
-  a {
+  color: #111;
+}
+
+h1 a, h1 a:link, h1 a:visited {
   text-decoration:none;
   color: #111;
-  }
-  @media screen and (min-width: 769px) {
-    &:hover {
-      top: -3.5rem;
-    }
+  &:hover, &:focus {
+    text-decoration:none;
+    color: #111;
   }
 }
 
@@ -226,6 +227,14 @@ header #title {
   @media screen and (max-width: 768px) { display: none; }
 }
 
+header {
+  background: linear-gradient(
+    135deg,
+    rgba(255, 174, 39, 1) 0%,
+    rgba(222, 73, 109, 1) 100%
+  );
+}
+
 header h1 small {
   display:block;
   font-size: 0.875rem;
@@ -550,7 +559,7 @@ button#disclaimer-close{
   }
 }
 
-h2 {
+h2.index-section {
   border-left: 0.3125rem solid #de4a6d;
   padding-left: 0.625rem;
   margin-top: 2rem;
@@ -764,3 +773,7 @@ button.next {
 body {
   overflow-x: hidden;
 }
+
+header {
+
+}
diff --git a/docs/node.html b/docs/node.html
index 95d446925..7530a7f47 100644
--- a/docs/node.html
+++ b/docs/node.html
@@ -1,4 +1,4 @@
-Node - 30 seconds of codeNode - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Node
atob
Decodes a string of data which has been encoded using base-64 encoding.
Create a Buffer for the given string with base-64 encoding and use Buffer.toString('binary') to return the decoded string.
const atob = str => new Buffer(str, 'base64').toString('binary');
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Node
atob
Decodes a string of data which has been encoded using base-64 encoding.
Create a Buffer for the given string with base-64 encoding and use Buffer.toString('binary') to return the decoded string.
const atob = str => new Buffer(str, 'base64').toString('binary');
 
atob('Zm9vYmFy'); // 'foobar'
 
btoa
Creates a base-64 encoded ASCII string from a String object in which each character in the string is treated as a byte of binary data.
Create a Buffer for the given string with binary encoding and use Buffer.toString('base64') to return the encoded string.
const btoa = str => new Buffer(str, 'binary').toString('base64');
 
btoa('foobar'); // 'Zm9vYmFy'
diff --git a/docs/object.html b/docs/object.html
index e0c09d916..dc0f43806 100644
--- a/docs/object.html
+++ b/docs/object.html
@@ -1,4 +1,4 @@
-Object - 30 seconds of codeObject - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Object
bindAll
Binds methods of an object to the object itself, overwriting the existing method.
Use Array.forEach() to return a function that uses Function.apply() to apply the given context (obj) to fn for each function specified.
const bindAll = (obj, ...fns) =>
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Object
bindAll
Binds methods of an object to the object itself, overwriting the existing method.
Use Array.forEach() to return a function that uses Function.apply() to apply the given context (obj) to fn for each function specified.
const bindAll = (obj, ...fns) =>
   fns.forEach(
     fn => (
       (f = obj[fn]),
diff --git a/docs/string.html b/docs/string.html
index 351b0c1a1..eddbe681f 100644
--- a/docs/string.html
+++ b/docs/string.html
@@ -1,4 +1,4 @@
-String - 30 seconds of codeString - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
String
byteSize
Returns the length of a string in bytes.
Convert a given string to a Blob Object and find its size.
const byteSize = str => new Blob([str]).size;
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
String
byteSize
Returns the length of a string in bytes.
Convert a given string to a Blob Object and find its size.
const byteSize = str => new Blob([str]).size;
 
byteSize('😀'); // 4
 byteSize('Hello World'); // 11
 
capitalize
Capitalizes the first letter of a string.
Use array destructuring and String.toUpperCase() to capitalize first letter, ...rest to get array of characters after first letter and then Array.join('') to make it a string again. Omit the lowerRest parameter to keep the rest of the string intact, or set it to true to convert to lowercase.
const capitalize = ([first, ...rest], lowerRest = false) =>
diff --git a/docs/type.html b/docs/type.html
index fb8701bf4..800975862 100644
--- a/docs/type.html
+++ b/docs/type.html
@@ -1,4 +1,4 @@
-Type - 30 seconds of codeType - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Type
getType
Returns the native type of a value.
Returns lowercased constructor name of value, "undefined" or "null" if value is undefined or null.
const getType = v =>
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Type
getType
Returns the native type of a value.
Returns lowercased constructor name of value, "undefined" or "null" if value is undefined or null.
const getType = v =>
   v === undefined ? 'undefined' : v === null ? 'null' : v.constructor.name.toLowerCase();
 
getType(new Set([1, 2, 3])); // 'set'
 
is
Checks if the provided value is of the specified type (doesn't work with literals).
Use the instanceof operator to check if the provided value is of the specified type.
const is = (type, val) => val instanceof type;
diff --git a/docs/utility.html b/docs/utility.html
index a53d284ad..f1a063400 100644
--- a/docs/utility.html
+++ b/docs/utility.html
@@ -1,4 +1,4 @@
-Utility - 30 seconds of codeUtility - 30 seconds of code
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Utility
castArray
Casts the provided value as an array if it's not one.
Use Array.isArray() to determine if val is an array and return it as-is or encapsulated in an array accordingly.
const castArray = val => (Array.isArray(val) ? val : [val]);
+      }
logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less.
 
Utility
castArray
Casts the provided value as an array if it's not one.
Use Array.isArray() to determine if val is an array and return it as-is or encapsulated in an array accordingly.
const castArray = val => (Array.isArray(val) ? val : [val]);
 
castArray('foo'); // ['foo']
 castArray([1]); // [1]
 
cloneRegExp
Clones a regular expression.
Use new RegExp(), RegExp.source and RegExp.flags to clone the given regular expression.
const cloneRegExp = regExp => new RegExp(regExp.source, regExp.flags);
diff --git a/scripts/web.js b/scripts/web.js
index 26f6454ce..0115e206c 100644
--- a/scripts/web.js
+++ b/scripts/web.js
@@ -159,7 +159,7 @@ try {
         `

`; for (let taggedSnippet of Object.entries(tagDbData).filter(v => v[1][0] === tag)) output += md - .render(`[${taggedSnippet[0]}](./${tag}.html#${taggedSnippet[0].toLowerCase()})\n`) + .render(`[${taggedSnippet[0]}](./${tag}#${taggedSnippet[0].toLowerCase()})\n`) .replace(/

/g, '') .replace(/<\/p>/g, '') .replace(/ t[1][0]))] .filter(v => v) .sort((a, b) => util.capitalize(a, true) === 'Uncategorized' ? 1 : util.capitalize(b, true) === 'Uncategorized' ? -1 : a.localeCompare(b))) { - let localOutput = output.replace(/\$tag/g, util.capitalize(tag)).replace(new RegExp(`./${tag}.html#`,'g'),'#'); + let localOutput = output.replace(/\$tag/g, util.capitalize(tag)).replace(new RegExp(`./${tag}#`,'g'),'#'); localOutput += md .render(`## ${util.capitalize(tag, true)}\n`) .replace(/

/g, '

'); diff --git a/static-parts/beginner-page-end.html b/static-parts/beginner-page-end.html index 6c016eca2..d6eafb24f 100644 --- a/static-parts/beginner-page-end.html +++ b/static-parts/beginner-page-end.html @@ -1,6 +1,7 @@ +
- \ No newline at end of file + diff --git a/static-parts/beginner-page-start.html b/static-parts/beginner-page-start.html index 8a2c37d4c..a4edfc5c6 100644 --- a/static-parts/beginner-page-start.html +++ b/static-parts/beginner-page-start.html @@ -1,12 +1,20 @@ + + + Snippets for Beginners - 30 seconds of code - + @@ -75,11 +83,11 @@ - +
-

logo 30 seconds of code

+

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

- +
diff --git a/static-parts/index.html b/static-parts/index.html index d6f90e7d6..8237e0034 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -1,6 +1,14 @@ + + + 30 seconds of code @@ -14,10 +22,11 @@ +

logo 30 seconds of code

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

- +
@@ -62,6 +71,7 @@

Today's picks

+

Our sophisticated robot helpers pick new snippets from our collection daily, so that you can discover new snippets to enhance your projects:

@@ -76,10 +86,10 @@

Getting started


@@ -215,6 +225,26 @@ window.onload = function(){ if ( event.target.classList.contains('collapse') ) { event.target.classList = event.target.classList.contains('toggled') ? 'collapse' : 'collapse toggled'; } + else if (event.target.classList.contains('clipboard-copy')) { + const text = event.target.parentElement.parentElement.querySelector(':not(pre) + pre').textContent; + const textArea = document.createElement("textarea"); + textArea.value = text.trim(); + document.body.appendChild(textArea); + textArea.select(); + document.execCommand("Copy"); + document.body.removeChild(textArea); + let tst = document.createElement('div'); + tst.classList = 'toast'; + tst.innerHTML = 'Snippet copied to clipboard!'; + document.body.appendChild(tst); + setTimeout(function() { + tst.style.opacity = 0; + setTimeout(function() { + document.body.removeChild(tst); + },300); + },1700); + } + }, false); } const runCounter = (selector, start, end, increment = 1, duration = 2000) => { diff --git a/static-parts/page-start.html b/static-parts/page-start.html index 36adbaba3..f4a4b92fd 100644 --- a/static-parts/page-start.html +++ b/static-parts/page-start.html @@ -1,6 +1,14 @@ + + + $tag - 30 seconds of code @@ -50,9 +58,6 @@ }; function loader() { registerClickListener(); - window.setTimeout(function(){ - document.getElementById('disclaimer').style.display = 'none'; - }, 30000); document.querySelector('nav').scrollTop = Array.from(document.querySelectorAll('h3')).filter(v => v.innerHTML === '$tag')[0].offsetTop - 60; } function registerClickListener() { @@ -98,11 +103,11 @@ - +
-

logo 30 seconds of code +

logo 30 seconds of code Curated collection of useful JavaScript snippets that you can understand in 30 seconds or less. -

+

From a64ce68619ba7bac56145af02fcf23709e2bd185 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 17:38:13 +0200 Subject: [PATCH 26/36] add archived-page static files --- scripts/web.js | 58 ++++++++++++++++ static-parts/archived-page-end.html | 7 ++ static-parts/archived-page-start.html | 98 +++++++++++++++++++++++++++ 3 files changed, 163 insertions(+) create mode 100644 static-parts/archived-page-end.html create mode 100644 static-parts/archived-page-start.html diff --git a/scripts/web.js b/scripts/web.js index 0115e206c..384212d9d 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -48,10 +48,12 @@ sass.render( ); // Set variables for paths const snippetsPath = './snippets', + archivedSnippetsPath = './snippets_archive', staticPartsPath = './static-parts', docsPath = './docs'; // Set variables for script let snippets = {}, + archivedSnippets = {}, beginnerSnippetNames = ['everyNth', 'filterNonUnique', 'last', 'maxN', 'minN', 'nthElement', 'sample', 'similarity', 'tail', 'currentURL', 'hasClass', 'getMeridiemSuffixOfInteger', 'factorial', 'fibonacci', 'gcd', 'isDivisible', 'isEven', 'isPrime', 'lcm', 'randomIntegerInRange', 'sum', 'reverseString', 'truncateString'], startPart = '', endPart = '', @@ -59,6 +61,10 @@ let snippets = {}, beginnerStartPart = '', beginnerEndPart = '', beginnerOutput = '', + archivedStartPart = '', + archivedEndPart = '', + archivedOutput = '', + indexStaticFile = '', pagesOutput = []; tagDbData = {}; @@ -66,6 +72,8 @@ let snippets = {}, console.time('Webber'); // Synchronously read all snippets and sort them as necessary (case-insensitive) snippets = util.readSnippets(snippetsPath); +archivedSnippets = util.readSnippets(archivedSnippetsPath); + // Load static parts for all pages try { @@ -75,6 +83,9 @@ try { beginnerStartPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-start.html'), 'utf8'); beginnerEndPart = fs.readFileSync(path.join(staticPartsPath, 'beginner-page-end.html'), 'utf8'); + archivedStartPart = fs.readFileSync(path.join(staticPartsPath, 'archived-page-start.html'), 'utf8'); + archivedEndPart = fs.readFileSync(path.join(staticPartsPath, 'archived-page-end.html'), 'utf8'); + indexStaticFile = fs.readFileSync(path.join(staticPartsPath, 'index.html'), 'utf8'); } catch (err) { // Handle errors (hopefully not!) @@ -271,5 +282,52 @@ try { process.exit(1); } +// Create the output for the beginner.html file +try { + // Add the static part + beginnerOutput += `${beginnerStartPart + '\n'}`; + + // Filter begginer snippets + const filteredBeginnerSnippets = Object.keys(snippets) + .filter(key => beginnerSnippetNames.map(name => name+'.md').includes(key)) + .reduce((obj, key) => { + obj[key] = snippets[key]; + return obj; + }, {}); + + for (let snippet of Object.entries(filteredBeginnerSnippets)) + beginnerOutput += + '
' + + '
' + + '
' + + md + .render(`\n${snippets[snippet[0]]}`) + .replace(/

/g, `${snippet[1].includes('advanced')?'advanced':''}

`) + .replace(/<\/h3>/g, '

') + .replace(/
([^\0]*?)<\/code><\/pre>/gm, (match, p1) => `
${Prism.highlight(unescapeHTML(p1), Prism.languages.javascript)}
`)
+            .replace(/<\/pre>\s+
📋 Copy to clipboard' +
+          '
'; + + // Optimize punctuation nodes + beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize operator nodes + beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + // Optimize keyword nodes + beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3) => `${p1}${p2}${p3}`); + + + beginnerOutput += `${beginnerEndPart}`; + + // Generate 'beginner.html' file + fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput); + console.log(`${chalk.green('SUCCESS!')} beginner.html file generated!`); + +} catch (err) { + console.log(`${chalk.red('ERROR!')} During beginner.html generation: ${err}`); + process.exit(1); +} + // Log the time taken console.timeEnd('Webber'); diff --git a/static-parts/archived-page-end.html b/static-parts/archived-page-end.html new file mode 100644 index 000000000..a2f9630f0 --- /dev/null +++ b/static-parts/archived-page-end.html @@ -0,0 +1,7 @@ + + + +
+ + + diff --git a/static-parts/archived-page-start.html b/static-parts/archived-page-start.html new file mode 100644 index 000000000..213214776 --- /dev/null +++ b/static-parts/archived-page-start.html @@ -0,0 +1,98 @@ + + + + + + + + Snippets for Beginners - 30 seconds of code + + + + + + + + + + + + + +
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+ +
+
+
+
+

Snippets Archive

+

These snippets, while useful and interesting, didn't quite make it into the repository due to either having very specific use-cases or being outdated. However we felt like they might still be useful to some readers, so here they are.


+
+
From b1b23df4b95b3a52a70dc361668a109a67dd439e Mon Sep 17 00:00:00 2001 From: Angelos Chalaris Date: Sat, 7 Apr 2018 19:10:42 +0300 Subject: [PATCH 27/36] Optimizations and manifest --- docs/adapter.html | 2 +- docs/array.html | 2 +- docs/beginner.html | 5 +- docs/browser.html | 2 +- docs/date.html | 2 +- docs/function.html | 2 +- docs/index.html | 121 +++++++++++++------------- docs/manifest.json | 14 +++ docs/math.html | 2 +- docs/mini.css | 2 +- docs/mini/flavor.scss | 8 +- docs/node.html | 2 +- docs/object.html | 2 +- docs/string.html | 2 +- docs/type.html | 2 +- docs/utility.html | 2 +- static-parts/beginner-page-start.html | 5 +- static-parts/index.html | 23 ++--- static-parts/page-start.html | 3 +- 19 files changed, 114 insertions(+), 89 deletions(-) create mode 100644 docs/manifest.json diff --git a/docs/adapter.html b/docs/adapter.html index 9656fbe99..5cfdc927f 100644 --- a/docs/adapter.html +++ b/docs/adapter.html @@ -1,4 +1,4 @@ -Adapter - 30 seconds of codeAdapter - 30 seconds of codeArray - 30 seconds of codeArray - 30 seconds of codeBrowser - 30 seconds of codeBrowser - 30 seconds of codeDate - 30 seconds of codeDate - 30 seconds of codeFunction - 30 seconds of codeFunction - 30 seconds of codeMath - 30 seconds of codeMath - 30 seconds of codeNode - 30 seconds of codeNode - 30 seconds of codeObject - 30 seconds of codeObject - 30 seconds of codeString - 30 seconds of codeString - 30 seconds of codeType - 30 seconds of codeType - 30 seconds of codeUtility - 30 seconds of codeUtility - 30 seconds of code diff --git a/static-parts/index.html b/static-parts/index.html index cdafb76fe..dcf1f9fc6 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -193,14 +193,14 @@ From cba7fd9f5a521f86159a493660f49c41d4b027b1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 18:21:47 +0200 Subject: [PATCH 29/36] update web.js to generate archive --- docs/archive.html | 124 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 docs/archive.html diff --git a/docs/archive.html b/docs/archive.html new file mode 100644 index 000000000..8a79d9ecd --- /dev/null +++ b/docs/archive.html @@ -0,0 +1,124 @@ + + + + + + + + Snippets for Beginners - 30 seconds of code + + + + + + + + + + + + + +
+

logo 30 seconds of code

+

Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.

+ +
+
+
+
+

Snippets Archive

+

These snippets, while useful and interesting, didn't quite make it into the repository due to either having very specific use-cases or being outdated. However we felt like they might still be useful to some readers, so here they are.


+
+
+ +

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+

undefined

+
+ + +
+ + + From 79d1cde71d575947d5ebb132488ae23f4339ea66 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20Feje=C5=A1?= Date: Sat, 7 Apr 2018 18:23:14 +0200 Subject: [PATCH 30/36] remove unnecessary console.logs --- docs/archive.html | 309 +++++++++++++++++++++++++++++++++++++++++++--- docs/index.html | 62 +++++----- scripts/web.js | 36 +++--- 3 files changed, 341 insertions(+), 66 deletions(-) diff --git a/docs/archive.html b/docs/archive.html index 8a79d9ecd..694b28123 100644 --- a/docs/archive.html +++ b/docs/archive.html @@ -97,24 +97,297 @@ -

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

-

undefined

+

binarySearch

+

Use recursion. Similar to Array.indexOf() that finds the index of a value within an array. +The difference being this operation only works with sorted arrays which offers a major performance boost due to it's logarithmic nature when compared to a linear search or Array.indexOf().

+

Search a sorted array by repeatedly dividing the search interval in half. +Begin with an interval covering the whole array. +If the value of the search is less than the item in the middle of the interval, recurse into the lower half. Otherwise recurse into the upper half. +Repeatedly recurse until the value is found which is the mid or you've recursed to a point that is greater than the length which means the value doesn't exist and return -1.

+
const binarySearch = (arr, val, start = 0, end = arr.length - 1) => {
+  if (start > end) return -1;
+  const mid = Math.floor((start + end) / 2);
+  if (arr[mid] > val) return binarySearch(arr, val, start, mid - 1);
+  if (arr[mid] < val) return binarySearch(arr, val, mid + 1, end);
+  return mid;
+};
+
binarySearch([1, 4, 6, 7, 12, 13, 15, 18, 19, 20, 22, 24], 6); // 2
+binarySearch([1, 4, 6, 7, 12, 13, 15, 18, 19, 20, 22, 24], 21); // -1
+
+

cleanObj

+

Removes any properties except the ones specified from a JSON object.

+

Use Object.keys() method to loop over given JSON object and deleting keys that are not included in given array. +If you pass a special key,childIndicator, it will search deeply apply the function to inner objects, too.

+
const cleanObj = (obj, keysToKeep = [], childIndicator) => {
+  Object.keys(obj).forEach(key => {
+    if (key === childIndicator) {
+      cleanObj(obj[key], keysToKeep, childIndicator);
+    } else if (!keysToKeep.includes(key)) {
+      delete obj[key];
+    }
+  });
+  return obj;
+};
+
const testObj = { a: 1, b: 2, children: { a: 1, b: 2 } };
+cleanObj(testObj, ['a'], 'children'); // { a: 1, children : { a: 1}}
+
+

collatz

+

Applies the Collatz algorithm.

+

If n is even, return n/2. Otherwise, return 3n+1.

+
const collatz = n => (n % 2 === 0 ? n / 2 : 3 * n + 1);
+
collatz(8); // 4
+
+

countVowels

+

Retuns number of vowels in provided string.

+

Use a regular expression to count the number of vowels (A, E, I, O, U) in a string.

+
const countVowels = str => (str.match(/[aeiou]/gi) || []).length;
+
countVowels('foobar'); // 3
+countVowels('gym'); // 0
+
+

factors

+

Returns the array of factors of the given num. +If the second argument is set to true returns only the prime factors of num. +If num is 1 or 0 returns an empty array. +If num is less than 0 returns all the factors of -int together with their additive inverses.

+

Use Array.from(), Array.map() and Array.filter() to find all the factors of num. +If given num is negative, use Array.reduce() to add the additive inverses to the array. +Return all results if primes is false, else determine and return only the prime factors using isPrime and Array.filter(). +Omit the second argument, primes, to return prime and non-prime factors by default.

+

Note:- Negative numbers are not considered prime.

+
const factors = (num, primes = false) => {
+  const isPrime = num => {
+    const boundary = Math.floor(Math.sqrt(num));
+    for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
+    return num >= 2;
+  };
+  const isNeg = num < 0;
+  num = isNeg ? -num : num;
+  let array = Array.from({ length: num - 1 })
+    .map((val, i) => (num % (i + 2) === 0 ? i + 2 : false))
+    .filter(val => val);
+  if (isNeg)
+    array = array.reduce((acc, val) => {
+      acc.push(val);
+      acc.push(-val);
+      return acc;
+    }, []);
+  return primes ? array.filter(isPrime) : array;
+};
+
factors(12); // [2,3,4,6,12]
+factors(12, true); // [2,3]
+factors(-12); // [2, -2, 3, -3, 4, -4, 6, -6, 12, -12]
+factors(-12, true); // [2,3]
+
+

fibonacciCountUntilNum

+

Returns the number of fibonnacci numbers up to num(0 and num inclusive).

+

Use a mathematical formula to calculate the number of fibonacci numbers until num.

+
const fibonacciCountUntilNum = num =>
+  Math.ceil(Math.log(num * Math.sqrt(5) + 1 / 2) / Math.log((Math.sqrt(5) + 1) / 2));
+
fibonacciCountUntilNum(10); // 7
+
+

fibonacciUntilNum

+

Generates an array, containing the Fibonacci sequence, up until the nth term.

+

Create an empty array of the specific length, initializing the first two values (0 and 1). +Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two. +Uses a mathematical formula to calculate the length of the array required.

+
const fibonacciUntilNum = num => {
+  let n = Math.ceil(Math.log(num * Math.sqrt(5) + 1 / 2) / Math.log((Math.sqrt(5) + 1) / 2));
+  return Array.from({ length: n }).reduce(
+    (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
+    []
+  );
+};
+
fibonacciUntilNum(10); // [ 0, 1, 1, 2, 3, 5, 8 ]
+
+

howManyTimes

+

Returns the number of times num can be divided by divisor (integer or fractional) without getting a fractional answer. +Works for both negative and positive integers.

+

If divisor is -1 or 1 return Infinity. +If divisor is -0 or 0 return 0. +Otherwise, keep dividing num with divisor and incrementing i, while the result is an integer. +Return the number of times the loop was executed, i.

+
const howManyTimes = (num, divisor) => {
+  if (divisor === 1 || divisor === -1) return Infinity;
+  if (divisor === 0) return 0;
+  let i = 0;
+  while (Number.isInteger(num / divisor)) {
+    i++;
+    num = num / divisor;
+  }
+  return i;
+};
+
howManyTimes(100, 2); // 2
+howManyTimes(100, 2.5); // 2
+howManyTimes(100, 0); // 0
+howManyTimes(100, -1); // Infinity
+
+

httpDelete

+

Makes a DELETE request to the passed URL.

+

Use XMLHttpRequest web api to make a delete request to the given url. +Handle the onload event, by running the provided callback function. +Handle the onerror event, by running the provided err function. +Omit the third argument, err to log the request to the console's error stream by default.

+
const httpDelete = (url, callback, err = console.error) => {
+  const request = new XMLHttpRequest();
+  request.open("DELETE", url, true);
+  request.onload = () => callback(request);
+  request.onerror = () => err(request);
+  request.send();
+};
+
httpDelete('https://website.com/users/123', request => {
+  console.log(request.responseText);
+}); // 'Deletes a user from the database'
+
+

httpPut

+

Makes a PUT request to the passed URL.

+

Use XMLHttpRequest web api to make a put request to the given url. +Set the value of an HTTP request header with setRequestHeader method. +Handle the onload event, by running the provided callback function. +Handle the onerror event, by running the provided err function. +Omit the last argument, err to log the request to the console's error stream by default.

+
const httpPut = (url, data, callback, err = console.error) => {
+    const request = new XMLHttpRequest();
+    request.open("PUT", url, true);
+    request.setRequestHeader('Content-type','application/json; charset=utf-8');
+    request.onload = () => callback(request);
+    request.onerror = () => err(request);
+    request.send(data);
+};
+
const password = "fooBaz";
+const data = JSON.stringify(password);
+httpPut('https://website.com/users/123', data, request => {
+  console.log(request.responseText);
+}); // 'Updates a user's password in database'
+
+

isArmstrongNumber

+

Checks if the given number is an Armstrong number or not.

+

Convert the given number into an array of digits. Use the exponent operator (**) to get the appropriate power for each digit and sum them up. If the sum is equal to the number itself, return true otherwise false.

+
const isArmstrongNumber = digits =>
+  (arr => arr.reduce((a, d) => a + parseInt(d) ** arr.length, 0) == digits)(
+    (digits + '').split('')
+  );
+
isArmstrongNumber(1634); // true
+isArmstrongNumber(56); // false
+
+

isSimilar

+

Determines if the pattern matches with str.

+

Use String.toLowerCase() to convert both strings to lowercase, then loop through str and determine if it contains all characters of pattern and in the correct order. +Adapted from here.

+
const isSimilar = (pattern, str) =>
+	[...str].reduce(
+		(matchIndex, char) => char.toLowerCase() === (pattern[matchIndex]  || '').toLowerCase() ? matchIndex + 1 : matchIndex, 0
+	) === pattern.length ? true : false;
+
isSimilar('rt','Rohit'); // true
+isSimilar('tr','Rohit'); // false
+
+

JSONToDate

+

Converts a JSON object to a date.

+

Use Date(), to convert dates in JSON format to readable format (dd/mm/yyyy).

+
const JSONToDate = arr => {
+  const dt = new Date(parseInt(arr.toString().substr(6)));
+  return `${dt.getDate()}/${dt.getMonth() + 1}/${dt.getFullYear()}`;
+};
+
JSONToDate(/Date(1489525200000)/); // "14/3/2017"
+
+

levenshteinDistance

+

Calculates the Levenshtein distance between two strings.

+

Calculates the number of changes (substitutions, deletions or additions) required to convert string1 to string2. +Can also be used to compare two strings as shown in the second example.

+
const levenshteinDistance  = (string1, string2) => {
+    if(string1.length === 0) return string2.length;
+    if(string2.length === 0) return string1.length;
+    let matrix = Array(string2.length + 1).fill(0).map((x,i) => [i]);
+    matrix[0] = Array(string1.length + 1).fill(0).map((x,i) => i);
+    for(let i = 1; i <= string2.length; i++){
+        for(let j = 1; j<=string1.length; j++){
+            if(string2[i-1] === string1[j-1]){
+                matrix[i][j] = matrix[i-1][j-1];
+            }
+            else{
+                matrix[i][j] = Math.min(matrix[i-1][j-1]+1, matrix[i][j-1]+1, matrix[i-1][j]+1);
+            }
+        }
+    }
+    return matrix[string2.length][string1.length];
+};
+
levenshteinDistance('30-seconds-of-code','30-seconds-of-python-code'); // 7
+const compareStrings = (string1,string2) => (100 - levenshteinDistance(string1,string2) / Math.max(string1.length,string2.length));
+compareStrings('30-seconds-of-code', '30-seconds-of-python-code'); // 99.72 (%)
+
+

quickSort

+

QuickSort an Array (ascending sort by default).

+

Use recursion. +Use Array.filter and spread operator (...) to create an array that all elements with values less than the pivot come before the pivot, and all elements with values greater than the pivot come after it. +If the parameter desc is truthy, return array sorts in descending order.

+
const quickSort = ([n, ...nums], desc) =>
+  isNaN(n)
+    ? []
+    : [
+        ...quickSort(nums.filter(v => (desc ? v > n : v <= n)), desc),
+        n,
+        ...quickSort(nums.filter(v => (!desc ? v > n : v <= n)), desc)
+      ];
+
quickSort([4, 1, 3, 2]); // [1,2,3,4]
+quickSort([4, 1, 3, 2], true); // [4,3,2,1]
+
+

removeVowels

+

Returns all the vowels in a str replaced by repl.

+

Use String.replace() with a regexp to replace all vowels in str. +Omot repl to use a default value of ''.

+
const removeVowels = (str, repl = '') => str.replace(/[aeiou]/gi,repl);
+
removeVowels("foobAr"); // "fbr"
+removeVowels("foobAr","*"); // "f**b*r"
+
+

solveRPN

+

Solves the given mathematical expression in reverse polish notation. +Throws appropriate errors if there are unrecognized symbols or the expression is wrong. The valid operators are :- +,-,*,/,^,** (^&** are the exponential symbols and are same). This snippet does not supports any unary operators.

+

Use a dictionary, OPERATORS to specify each operator's matching mathematical operation. +Use String.replace() with a regular expression to replace ^ with **, String.split() to tokenize the string and Array.filter() to remove empty tokens. +Use Array.forEach() to parse each symbol, evaluate it as a numeric value or operator and solve the mathematical expression. +Numeric values are converted to floating point numbers and pushed to a stack, while operators are evaluated using the OPERATORS dictionary and pop elements from the stack to apply operations.

+
const solveRPN = rpn => {
+  const OPERATORS = {
+    '*': (a, b) => a * b,
+    '+': (a, b) => a + b,
+    '-': (a, b) => a - b,
+    '/': (a, b) => a / b,
+    '**': (a, b) => a ** b
+  };
+  const [stack, solve] = [
+    [],
+    rpn
+      .replace(/\^/g, '**')
+      .split(/\s+/g)
+      .filter(el => !/\s+/.test(el) && el !== '')
+  ];
+  solve.forEach(symbol => {
+    if (!isNaN(parseFloat(symbol)) && isFinite(symbol)) {
+      stack.push(symbol);
+    } else if (Object.keys(OPERATORS).includes(symbol)) {
+      const [a, b] = [stack.pop(), stack.pop()];
+      stack.push(OPERATORS[symbol](parseFloat(b), parseFloat(a)));
+    } else {
+      throw `${symbol} is not a recognized symbol`;
+    }
+  });
+  if (stack.length === 1) return stack.pop();
+  else throw `${rpn} is not a proper RPN. Please check it and try again`;
+};
+
solveRPN('15 7 1 1 + - / 3 * 2 1 1 + + -'); // 5
+solveRPN('2 3 ^'); // 8
+
+

speechSynthesis

+

Performs speech synthesis (experimental).

+

Use SpeechSynthesisUtterance.voice and window.speechSynthesis.getVoices() to convert a message to speech. +Use window.speechSynthesis.speak() to play the message.

+

Learn more about the SpeechSynthesisUtterance interface of the Web Speech API.

+
const speechSynthesis = message => {
+  const msg = new SpeechSynthesisUtterance(message);
+  msg.voice = window.speechSynthesis.getVoices()[0];
+  window.speechSynthesis.speak(msg);
+};
+
speechSynthesis('Hello, World'); // // plays the message
+
diff --git a/docs/index.html b/docs/index.html index b3bdc1b95..22c9b9683 100644 --- a/docs/index.html +++ b/docs/index.html @@ -46,7 +46,7 @@
-

19462
stars

+

19461
stars

@@ -76,38 +76,38 @@
-

byteSize

-

Returns the length of a string in bytes.

-

Convert a given string to a Blob Object and find its size.

-
const byteSize = str => new Blob([str]).size;
-
byteSize('😀'); // 4
-byteSize('Hello World'); // 11
+      
reduceWhich

+
Returns the minimum/maximum value of an array, after applying the provided function to set comparing rule.

+
Use Array.reduce() in combination with the comparator function to get the appropriate element in the array.
+You can omit the second parameter, comparator, to use the default one that returns the minimum element in the array.

+
const reduceWhich = (arr, comparator = (a, b) => a - b) =>
+  arr.reduce((a, b) => (comparator(a, b) >= 0 ? b : a));
+
reduceWhich([1, 3, 2]); // 1
+reduceWhich([1, 3, 2], (a, b) => b - a); // 3
+reduceWhich(
+  [{ name: 'Tom', age: 12 }, { name: 'Jack', age: 18 }, { name: 'Lucy', age: 9 }],
+  (a, b) => a.age - b.age
+); // {name: "Lucy", age: 9}
 

-
hashNode

-
Creates a hash for a value using the SHA-256 algorithm. Returns a promise.

-
Use crypto API to create a hash for the given value.

-
const crypto = require('crypto');
-const hashNode = val =>
-  new Promise(resolve =>
-    setTimeout(
-      () =>
-        resolve(
-          crypto
-            .createHash('sha256')
-            .update(val)
-            .digest('hex')
-        ),
-      0
-    )
+
uniqueElements

+
Returns all unique values of an array.

+
Use ES6 Set and the ...rest operator to discard all duplicated values.

+
const uniqueElements = arr => [...new Set(arr)];
+
uniqueElements([1, 2, 2, 3, 4, 4, 5]); // [1,2,3,4,5]
+

+
unzip

+
Creates an array of arrays, ungrouping the elements in an array produced by zip.

+
Use Math.max.apply() to get the longest subarray in the array, Array.map() to make each element an array.
+Use Array.reduce() and Array.forEach() to map grouped values to individual arrays.

+
const unzip = arr =>
+  arr.reduce(
+    (acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
+    Array.from({
+      length: Math.max(...arr.map(x => x.length))
+    }).map(x => [])
   );
-
hashNode(JSON.stringify({ a: 'a', b: [1, 2, 3, 4], foo: { c: 'bar' } })).then(console.log); // '04aa106279f5977f59f9067fa9712afc4aedc6f5862a8defc34552d8c7206393'
-

-
take

-
Returns an array with n elements removed from the beginning.

-
Use Array.slice() to create a slice of the array with n elements taken from the beginning.

-
const take = (arr, n = 1) => arr.slice(0, n);
-
take([1, 2, 3], 5); // [1, 2, 3]
-take([1, 2, 3], 0); // []
+
unzip([['a', 1, true], ['b', 2, false]]); //[['a', 'b'], [1, 2], [true, false]]
+unzip([['a', 1, true], ['b', 2]]); //[['a', 'b'], [1, 2], [true]]
 

 

       

diff --git a/scripts/web.js b/scripts/web.js
index 384212d9d..93f3c0406 100644
--- a/scripts/web.js
+++ b/scripts/web.js
@@ -282,28 +282,30 @@ try {
   process.exit(1);
 }
 
-// Create the output for the beginner.html file
+// Create the output for the archive.html file
 try {
   // Add the static part
-  beginnerOutput += `${beginnerStartPart + '\n'}`;
+  archivedOutput += `${archivedStartPart + '\n'}`;
 
-  // Filter begginer snippets
-  const filteredBeginnerSnippets = Object.keys(snippets)
-    .filter(key => beginnerSnippetNames.map(name => name+'.md').includes(key))
+  // Filter README.md from folder
+  const excludeFiles = ['README.md'];
+
+  const filteredArchivedSnippets = Object.keys(archivedSnippets)
+    .filter(key => !excludeFiles.includes(key))
     .reduce((obj, key) => {
-      obj[key] = snippets[key];
+      obj[key] = archivedSnippets[key];
     return obj;
   }, {});
 
-  for (let snippet of Object.entries(filteredBeginnerSnippets))
-        beginnerOutput +=
+  // Generate archived snippets from md files
+  for (let snippet of Object.entries(filteredArchivedSnippets))
+        archivedOutput +=
         '
' +
         '
' +
           '
' +
           md
-            .render(`\n${snippets[snippet[0]]}`)
+            .render(`\n${filteredArchivedSnippets[snippet[0]]}`)
             .replace(/
/g, `${snippet[1].includes('advanced')?'advanced':''}
`)
             .replace(/<\/h3>/g, '
')
             .replace(/
([^\0]*?)<\/code><\/pre>/gm, (match, p1) => `
${Prism.highlight(unescapeHTML(p1), Prism.languages.javascript)}
`)
             .replace(/<\/pre>\s+
';
 
         // Optimize punctuation nodes
-        beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3)  => `${p1}${p2}${p3}`);
+        archivedOutput = util.optimizeNodes(archivedOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3)  => `${p1}${p2}${p3}`);
         // Optimize operator nodes
-        beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3)  => `${p1}${p2}${p3}`);
+        archivedOutput = util.optimizeNodes(archivedOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3)  => `${p1}${p2}${p3}`);
         // Optimize keyword nodes
-        beginnerOutput = util.optimizeNodes(beginnerOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3)  => `${p1}${p2}${p3}`);
+        archivedOutput = util.optimizeNodes(archivedOutput, /([^\0<]*?)<\/span>([\n\r\s]*)([^\0]*?)<\/span>/gm, (match, p1, p2, p3)  => `${p1}${p2}${p3}`);
 
 
-  beginnerOutput += `${beginnerEndPart}`;
+        archivedOutput += `${archivedEndPart}`;
 
   // Generate 'beginner.html' file
-  fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput);
-  console.log(`${chalk.green('SUCCESS!')} beginner.html file generated!`);
+  fs.writeFileSync(path.join(docsPath, 'archive.html'), archivedOutput);
+  console.log(`${chalk.green('SUCCESS!')} archive.html file generated!`);
 
 } catch (err) {
-  console.log(`${chalk.red('ERROR!')} During beginner.html generation: ${err}`);
+  console.log(`${chalk.red('ERROR!')} During archive.html generation: ${err}`);
   process.exit(1);
 }
 

From 26664df5f46a2e2cc0dad315fdbfdf4a717b7c8d Mon Sep 17 00:00:00 2001
From: Angelos Chalaris 
Date: Sat, 7 Apr 2018 19:36:36 +0300
Subject: [PATCH 31/36] Optimized archive

---
 docs/archive.html                     |  3 +-
 docs/index.html                       | 64 ++++++++++++++-------------
 static-parts/archived-page-start.html |  5 ++-
 static-parts/beginner-page-start.html |  2 +-
 4 files changed, 40 insertions(+), 34 deletions(-)

diff --git a/docs/archive.html b/docs/archive.html
index 694b28123..e841ac185 100644
--- a/docs/archive.html
+++ b/docs/archive.html
@@ -16,10 +16,11 @@
     
     
     
+    
     
     
     
-    
+    
     
     
-    Snippets for Beginners - 30 seconds of code
+    Snippets Archive - 30 seconds of code
     
     
     
     
     
+    
     
     
     
-    
+    
     
-    
-    
-    Snippets for Beginners - 30 seconds of code
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    Snippets Archive - 30 seconds of code
-  
-  
-      
-    

-      
logo 30 seconds of code

-      
Curated collection of useful JavaScript snippets
 that you can understand in 30 seconds or less.

-      
-    

-    

-      

-        

-            
Snippets Archive

-            
These snippets, while useful and interesting, didn't quite make it into the repository due to either having very specific use-cases or being outdated. However we felt like they might still be useful to some readers, so here they are.


-        

-      

-
-
binarySearch

-
Use recursion. Similar to Array.indexOf() that finds the index of a value within an array.
-The difference being this operation only works with sorted arrays which offers a major performance boost due to it's logarithmic nature when compared to a linear search or Array.indexOf().

-
Search a sorted array by repeatedly dividing the search interval in half.
-Begin with an interval covering the whole array.
-If the value of the search is less than the item in the middle of the interval, recurse into the lower half. Otherwise recurse into the upper half.
-Repeatedly recurse until the value is found which is the mid or you've recursed to a point that is greater than the length which means the value doesn't exist and return -1.

-
const binarySearch = (arr, val, start = 0, end = arr.length - 1) => {
+      }
logo 30 seconds of code
Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.
Snippets Archive
These snippets, while useful and interesting, didn't quite make it into the repository due to either having very specific use-cases or being outdated. However we felt like they might still be useful to some readers, so here they are.

binarySearch
Use recursion. Similar to Array.indexOf() that finds the index of a value within an array. The difference being this operation only works with sorted arrays which offers a major performance boost due to it's logarithmic nature when compared to a linear search or Array.indexOf().
Search a sorted array by repeatedly dividing the search interval in half. Begin with an interval covering the whole array. If the value of the search is less than the item in the middle of the interval, recurse into the lower half. Otherwise recurse into the upper half. Repeatedly recurse until the value is found which is the mid or you've recursed to a point that is greater than the length which means the value doesn't exist and return -1.
const binarySearch = (arr, val, start = 0, end = arr.length - 1) => {
   if (start > end) return -1;
   const mid = Math.floor((start + end) / 2);
   if (arr[mid] > val) return binarySearch(arr, val, start, mid - 1);
@@ -114,12 +65,7 @@ Repeatedly recurse until the value is found which is the mid or you've recursed
 };
 
binarySearch([1, 4, 6, 7, 12, 13, 15, 18, 19, 20, 22, 24], 6); // 2
 binarySearch([1, 4, 6, 7, 12, 13, 15, 18, 19, 20, 22, 24], 21); // -1
-

-
cleanObj

-
Removes any properties except the ones specified from a JSON object.

-
Use Object.keys() method to loop over given JSON object and deleting keys that are not included in given array.
-If you pass a special key,childIndicator, it will search deeply apply the function to inner objects, too.

-
const cleanObj = (obj, keysToKeep = [], childIndicator) => {
+
cleanObj
Removes any properties except the ones specified from a JSON object.
Use Object.keys() method to loop over given JSON object and deleting keys that are not included in given array. If you pass a special key,childIndicator, it will search deeply apply the function to inner objects, too.
const cleanObj = (obj, keysToKeep = [], childIndicator) => {
   Object.keys(obj).forEach(key => {
     if (key === childIndicator) {
       cleanObj(obj[key], keysToKeep, childIndicator);
@@ -131,31 +77,12 @@ If you pass a special key,childIndicator, it will search deeply app
 };
 
const testObj = { a: 1, b: 2, children: { a: 1, b: 2 } };
 cleanObj(testObj, ['a'], 'children'); // { a: 1, children : { a: 1}}
-

-
collatz

-
Applies the Collatz algorithm.

-
If n is even, return n/2. Otherwise, return 3n+1.

-
const collatz = n => (n % 2 === 0 ? n / 2 : 3 * n + 1);
+
collatz
Applies the Collatz algorithm.
If n is even, return n/2. Otherwise, return 3n+1.
const collatz = n => (n % 2 === 0 ? n / 2 : 3 * n + 1);
 
collatz(8); // 4
-

-
countVowels

-
Retuns number of vowels in provided string.

-
Use a regular expression to count the number of vowels (A, E, I, O, U) in a string.

-
const countVowels = str => (str.match(/[aeiou]/gi) || []).length;
+
countVowels
Retuns number of vowels in provided string.
Use a regular expression to count the number of vowels (A, E, I, O, U) in a string.
const countVowels = str => (str.match(/[aeiou]/gi) || []).length;
 
countVowels('foobar'); // 3
 countVowels('gym'); // 0
-

-
factors

-
Returns the array of factors of the given num.
-If the second argument is set to true returns only the prime factors of num.
-If num is 1 or 0 returns an empty array.
-If num is less than 0 returns all the factors of -int together with their additive inverses.

-
Use Array.from(), Array.map() and Array.filter() to find all the factors of num.
-If given num is negative, use Array.reduce() to add the additive inverses to the array.
-Return all results if primes is false, else determine and return only the prime factors using isPrime and Array.filter().
-Omit the second argument, primes, to return prime and non-prime factors by default.

-
Note:- Negative numbers are not considered prime.

-
const factors = (num, primes = false) => {
+
factors
Returns the array of factors of the given num. If the second argument is set to true returns only the prime factors of num. If num is 1 or 0 returns an empty array. If num is less than 0 returns all the factors of -int together with their additive inverses.
Use Array.from(), Array.map() and Array.filter() to find all the factors of num. If given num is negative, use Array.reduce() to add the additive inverses to the array. Return all results if primes is false, else determine and return only the prime factors using isPrime and Array.filter(). Omit the second argument, primes, to return prime and non-prime factors by default.
Note:- Negative numbers are not considered prime.
const factors = (num, primes = false) => {
   const isPrime = num => {
     const boundary = Math.floor(Math.sqrt(num));
     for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
@@ -178,20 +105,10 @@ Omit the second argument, primes, to return prime and non-prime fac
 factors(12, true); // [2,3]
 factors(-12); // [2, -2, 3, -3, 4, -4, 6, -6, 12, -12]
 factors(-12, true); // [2,3]
-

-
fibonacciCountUntilNum

-
Returns the number of fibonnacci numbers up to num(0 and num inclusive).

-
Use a mathematical formula to calculate the number of fibonacci numbers until num.

-
const fibonacciCountUntilNum = num =>
+
fibonacciCountUntilNum
Returns the number of fibonnacci numbers up to num(0 and num inclusive).
Use a mathematical formula to calculate the number of fibonacci numbers until num.
const fibonacciCountUntilNum = num =>
   Math.ceil(Math.log(num * Math.sqrt(5) + 1 / 2) / Math.log((Math.sqrt(5) + 1) / 2));
 
fibonacciCountUntilNum(10); // 7
-

-
fibonacciUntilNum

-
Generates an array, containing the Fibonacci sequence, up until the nth term.

-
Create an empty array of the specific length, initializing the first two values (0 and 1).
-Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.
-Uses a mathematical formula to calculate the length of the array required.

-
const fibonacciUntilNum = num => {
+
fibonacciUntilNum
Generates an array, containing the Fibonacci sequence, up until the nth term.
Create an empty array of the specific length, initializing the first two values (0 and 1). Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two. Uses a mathematical formula to calculate the length of the array required.
const fibonacciUntilNum = num => {
   let n = Math.ceil(Math.log(num * Math.sqrt(5) + 1 / 2) / Math.log((Math.sqrt(5) + 1) / 2));
   return Array.from({ length: n }).reduce(
     (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
@@ -199,15 +116,7 @@ Uses a mathematical formula to calculate the length of the array required.

   );
 };
 
fibonacciUntilNum(10); // [ 0, 1, 1, 2, 3, 5, 8 ]
-

-
howManyTimes

-
Returns the number of times num can be divided by divisor (integer or fractional) without getting a fractional answer.
-Works for both negative and positive integers.

-
If divisor is -1 or 1 return Infinity.
-If divisor is -0 or 0 return 0.
-Otherwise, keep dividing num with divisor and incrementing i, while the result is an integer.
-Return the number of times the loop was executed, i.

-
const howManyTimes = (num, divisor) => {
+
howManyTimes
Returns the number of times num can be divided by divisor (integer or fractional) without getting a fractional answer. Works for both negative and positive integers.
If divisor is -1 or 1 return Infinity. If divisor is -0 or 0 return 0. Otherwise, keep dividing num with divisor and incrementing i, while the result is an integer. Return the number of times the loop was executed, i.
const howManyTimes = (num, divisor) => {
   if (divisor === 1 || divisor === -1) return Infinity;
   if (divisor === 0) return 0;
   let i = 0;
@@ -221,14 +130,7 @@ Return the number of times the loop was executed, i.

 howManyTimes(100, 2.5); // 2
 howManyTimes(100, 0); // 0
 howManyTimes(100, -1); // Infinity
-

-
httpDelete

-
Makes a DELETE request to the passed URL.

-
Use XMLHttpRequest web api to make a delete request to the given url.
-Handle the onload event, by running the provided callback function.
-Handle the onerror event, by running the provided err function.
-Omit the third argument, err to log the request to the console's error stream by default.

-
const httpDelete = (url, callback, err = console.error) => {
+
httpDelete
Makes a DELETE request to the passed URL.
Use XMLHttpRequest web api to make a delete request to the given url. Handle the onload event, by running the provided callback function. Handle the onerror event, by running the provided err function. Omit the third argument, err to log the request to the console's error stream by default.
const httpDelete = (url, callback, err = console.error) => {
   const request = new XMLHttpRequest();
   request.open("DELETE", url, true);
   request.onload = () => callback(request);
@@ -238,15 +140,7 @@ Omit the third argument, err to log the request to the console's er
 
httpDelete('https://website.com/users/123', request => {
   console.log(request.responseText);
 }); // 'Deletes a user from the database'
-

-
httpPut

-
Makes a PUT request to the passed URL.

-
Use XMLHttpRequest web api to make a put request to the given url.
-Set the value of an HTTP request header with setRequestHeader method.
-Handle the onload event, by running the provided callback function.
-Handle the onerror event, by running the provided err function.
-Omit the last argument, err to log the request to the console's error stream by default.

-
const httpPut = (url, data, callback, err = console.error) => {
+
httpPut
Makes a PUT request to the passed URL.
Use XMLHttpRequest web api to make a put request to the given url. Set the value of an HTTP request header with setRequestHeader method. Handle the onload event, by running the provided callback function. Handle the onerror event, by running the provided err function. Omit the last argument, err to log the request to the console's error stream by default.
const httpPut = (url, data, callback, err = console.error) => {
     const request = new XMLHttpRequest();
     request.open("PUT", url, true);
     request.setRequestHeader('Content-type','application/json; charset=utf-8');
@@ -259,42 +153,24 @@ Omit the last argument, err to log the request to the console's err
 httpPut('https://website.com/users/123', data, request => {
   console.log(request.responseText);
 }); // 'Updates a user's password in database'
-

-
isArmstrongNumber

-
Checks if the given number is an Armstrong number or not.

-
Convert the given number into an array of digits. Use the exponent operator (**) to get the appropriate power for each digit and sum them up. If the sum is equal to the number itself, return true otherwise false.

-
const isArmstrongNumber = digits =>
+
isArmstrongNumber
Checks if the given number is an Armstrong number or not.
Convert the given number into an array of digits. Use the exponent operator (**) to get the appropriate power for each digit and sum them up. If the sum is equal to the number itself, return true otherwise false.
const isArmstrongNumber = digits =>
   (arr => arr.reduce((a, d) => a + parseInt(d) ** arr.length, 0) == digits)(
     (digits + '').split('')
   );
 
isArmstrongNumber(1634); // true
 isArmstrongNumber(56); // false
-

-
isSimilar

-
Determines if the pattern matches with str.

-
Use String.toLowerCase() to convert both strings to lowercase, then loop through str and determine if it contains all characters of pattern and in the correct order.
-Adapted from here.

-
const isSimilar = (pattern, str) =>
+
isSimilar
Determines if the pattern matches with str.
Use String.toLowerCase() to convert both strings to lowercase, then loop through str and determine if it contains all characters of pattern and in the correct order. Adapted from here.
const isSimilar = (pattern, str) =>
 	[...str].reduce(
 		(matchIndex, char) => char.toLowerCase() === (pattern[matchIndex]  || '').toLowerCase() ? matchIndex + 1 : matchIndex, 0
 	) === pattern.length ? true : false;
 
isSimilar('rt','Rohit'); // true
 isSimilar('tr','Rohit'); // false
-

-
JSONToDate

-
Converts a JSON object to a date.

-
Use Date(), to convert dates in JSON format to readable format (dd/mm/yyyy).

-
const JSONToDate = arr => {
+
JSONToDate
Converts a JSON object to a date.
Use Date(), to convert dates in JSON format to readable format (dd/mm/yyyy).
const JSONToDate = arr => {
   const dt = new Date(parseInt(arr.toString().substr(6)));
   return `${dt.getDate()}/${dt.getMonth() + 1}/${dt.getFullYear()}`;
 };
 
JSONToDate(/Date(1489525200000)/); // "14/3/2017"
-

-
levenshteinDistance

-
Calculates the Levenshtein distance between two strings.

-
Calculates the number of changes (substitutions, deletions or additions) required to convert string1 to string2.
-Can also be used to compare two strings as shown in the second example.

-
const levenshteinDistance  = (string1, string2) => {
+
levenshteinDistance
Calculates the Levenshtein distance between two strings.
Calculates the number of changes (substitutions, deletions or additions) required to convert string1 to string2. Can also be used to compare two strings as shown in the second example.
const levenshteinDistance  = (string1, string2) => {
     if(string1.length === 0) return string2.length;
     if(string2.length === 0) return string1.length;
     let matrix = Array(string2.length + 1).fill(0).map((x,i) => [i]);
@@ -314,13 +190,7 @@ Can also be used to compare two strings as shown in the second example.

 
levenshteinDistance('30-seconds-of-code','30-seconds-of-python-code'); // 7
 const compareStrings = (string1,string2) => (100 - levenshteinDistance(string1,string2) / Math.max(string1.length,string2.length));
 compareStrings('30-seconds-of-code', '30-seconds-of-python-code'); // 99.72 (%)
-

-
quickSort

-
QuickSort an Array (ascending sort by default).

-
Use recursion.
-Use Array.filter and spread operator (...) to create an array that all elements with values less than the pivot come before the pivot, and all elements with values greater than the pivot come after it.
-If the parameter desc is truthy, return array sorts in descending order.

-
const quickSort = ([n, ...nums], desc) =>
+
quickSort
QuickSort an Array (ascending sort by default).
Use recursion. Use Array.filter and spread operator (...) to create an array that all elements with values less than the pivot come before the pivot, and all elements with values greater than the pivot come after it. If the parameter desc is truthy, return array sorts in descending order.
const quickSort = ([n, ...nums], desc) =>
   isNaN(n)
     ? []
     : [
@@ -330,23 +200,10 @@ If the parameter desc is truthy, return array sorts in descending o
       ];
 
quickSort([4, 1, 3, 2]); // [1,2,3,4]
 quickSort([4, 1, 3, 2], true); // [4,3,2,1]
-

-
removeVowels

-
Returns all the vowels in a str replaced by repl.

-
Use String.replace() with a regexp to replace all vowels in str.
-Omot repl to use a default value of ''.

-
const removeVowels = (str, repl = '') => str.replace(/[aeiou]/gi,repl);
+
removeVowels
Returns all the vowels in a str replaced by repl.
Use String.replace() with a regexp to replace all vowels in str. Omot repl to use a default value of ''.
const removeVowels = (str, repl = '') => str.replace(/[aeiou]/gi,repl);
 
removeVowels("foobAr"); // "fbr"
 removeVowels("foobAr","*"); // "f**b*r"
-

-
solveRPN

-
Solves the given mathematical expression in reverse polish notation.
-Throws appropriate errors if there are unrecognized symbols or the expression is wrong. The valid operators are :- +,-,*,/,^,** (^&** are the exponential symbols and are same). This snippet does not supports any unary operators.

-
Use a dictionary, OPERATORS to specify each operator's matching mathematical operation.
-Use String.replace() with a regular expression to replace ^ with **, String.split() to tokenize the string and Array.filter() to remove empty tokens.
-Use Array.forEach() to parse each symbol, evaluate it as a numeric value or operator and solve the mathematical expression.
-Numeric values are converted to floating point numbers and pushed to a stack, while operators are evaluated using the OPERATORS dictionary and pop elements from the stack to apply operations.

-
const solveRPN = rpn => {
+
solveRPN
Solves the given mathematical expression in reverse polish notation. Throws appropriate errors if there are unrecognized symbols or the expression is wrong. The valid operators are :- +,-,*,/,^,** (^&** are the exponential symbols and are same). This snippet does not supports any unary operators.
Use a dictionary, OPERATORS to specify each operator's matching mathematical operation. Use String.replace() with a regular expression to replace ^ with **, String.split() to tokenize the string and Array.filter() to remove empty tokens. Use Array.forEach() to parse each symbol, evaluate it as a numeric value or operator and solve the mathematical expression. Numeric values are converted to floating point numbers and pushed to a stack, while operators are evaluated using the OPERATORS dictionary and pop elements from the stack to apply operations.
const solveRPN = rpn => {
   const OPERATORS = {
     '*': (a, b) => a * b,
     '+': (a, b) => a + b,
@@ -376,23 +233,10 @@ Numeric values are converted to floating point numbers and pushed to a sta
 };
 
solveRPN('15 7 1 1 + - / 3 * 2 1 1 + + -'); // 5
 solveRPN('2 3 ^'); // 8
-

-
speechSynthesis

-
Performs speech synthesis (experimental).

-
Use SpeechSynthesisUtterance.voice and window.speechSynthesis.getVoices() to convert a message to speech.
-Use window.speechSynthesis.speak() to play the message.

-
Learn more about the SpeechSynthesisUtterance interface of the Web Speech API.

-
const speechSynthesis = message => {
+
speechSynthesis
Performs speech synthesis (experimental).
Use SpeechSynthesisUtterance.voice and window.speechSynthesis.getVoices() to convert a message to speech. Use window.speechSynthesis.speak() to play the message.
Learn more about the SpeechSynthesisUtterance interface of the Web Speech API.
const speechSynthesis = message => {
   const msg = new SpeechSynthesisUtterance(message);
   msg.voice = window.speechSynthesis.getVoices()[0];
   window.speechSynthesis.speak(msg);
 };
 
speechSynthesis('Hello, World'); // // plays the message
-

-

-

-
-

-
-
-
+

\ No newline at end of file diff --git a/docs/beginner.html b/docs/beginner.html index 101a5db4c..162c1f056 100644 --- a/docs/beginner.html +++ b/docs/beginner.html @@ -93,7 +93,7 @@
-

Beginner snippets

+

Snippets for Beginners

The following section is aimed towards individuals who are at the start of their web developer journey. Each snippet in the next section is simple yet very educational for newcomers. This section is by no means a complete resource for learning modern JavaScript. However, it is enough to grasp some common concepts and use cases. We also strongly recommend checking out MDN web docs as a learning resource.


diff --git a/docs/index.html b/docs/index.html index 3fd8cfb4e..8ce2b51d1 100644 --- a/docs/index.html +++ b/docs/index.html @@ -76,42 +76,39 @@
-

createElement

-

Creates an element from a string (without appending it to the document). -If the given string contains multiple elements, only the first one will be returned.

-

Use document.createElement() to create a new element. -Set its innerHTML to the string supplied as the argument. -Use ParentNode.firstElementChild to return the element version of the string.

-
const createElement = str => {
-  const el = document.createElement('div');
-  el.innerHTML = str;
-  return el.firstElementChild;
-};
-
const el = createElement(
-  `<div class="container">
-    <p>Hello!</p>
-  </div>`
-);
-console.log(el.className); // 'container'
+      
get

+
Retrieve a set of properties indicated by the given selectors from an object.

+
Use Array.map() for each selector, String.replace() to replace square brackets with dots, String.split('.') to split each selector, Array.filter() to remove empty values and Array.reduce() to get the value indicated by it.

+
const get = (from, ...selectors) =>
+  [...selectors].map(s =>
+    s
+      .replace(/\[([^\[\]]*)\]/g, '.$1.')
+      .split('.')
+      .filter(t => t !== '')
+      .reduce((prev, cur) => prev && prev[cur], from)
+  );
+
const obj = { selector: { to: { val: 'val to select' } }, target: [1, 2, { a: 'test' }] };
+get(obj, 'selector.to.val', 'target[0]', 'target[2].a'); // ['val to select', 1, 'test']
 

-
isSymbol

-
Checks if the given argument is a symbol.

-
Use typeof to check if a value is classified as a symbol primitive.

-
const isSymbol = val => typeof val === 'symbol';
-
isSymbol(Symbol('x')); // true
+
toDecimalMark

+
Use toLocaleString() to convert a float-point arithmetic to the Decimal mark form. It makes a comma separated string from a number.

+
const toDecimalMark = num => num.toLocaleString('en-US');
+
toDecimalMark(12305030388.9087); // "12,305,030,388.909"
 

-
scrollToTop

-
Smooth-scrolls to the top of the page.

-
Get distance from top using document.documentElement.scrollTop or document.body.scrollTop.
-Scroll by a fraction of the distance from the top. Use window.requestAnimationFrame() to animate the scrolling.

-
const scrollToTop = () => {
-  const c = document.documentElement.scrollTop || document.body.scrollTop;
-  if (c > 0) {
-    window.requestAnimationFrame(scrollToTop);
-    window.scrollTo(0, c - c / 8);
-  }
-};
-
scrollToTop();
+
toKebabCase

+
Converts a string to kebab case.

+
Break the string into words and combine them adding - as a separator, using a regexp.

+
const toKebabCase = str =>
+  str &&
+  str
+    .match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)
+    .map(x => x.toLowerCase())
+    .join('-');
+
toKebabCase('camelCase'); // 'camel-case'
+toKebabCase('some text'); // 'some-text'
+toKebabCase('some-mixed_string With spaces_underscores-and-hyphens'); // 'some-mixed-string-with-spaces-underscores-and-hyphens'
+toKebabCase('AllThe-small Things'); // "all-the-small-things"
+toKebabCase('IAmListeningToFMWhileLoadingDifferentURLOnMyBrowserAndAlsoEditingSomeXMLAndHTML'); // "i-am-listening-to-fm-while-loading-different-url-on-my-browser-and-also-editing-xml-and-html"
 

 

       

diff --git a/scripts/web.js b/scripts/web.js
index 93f3c0406..e81a6c840 100644
--- a/scripts/web.js
+++ b/scripts/web.js
@@ -322,8 +322,26 @@ try {
 
         archivedOutput += `${archivedEndPart}`;
 
-  // Generate 'beginner.html' file
-  fs.writeFileSync(path.join(docsPath, 'archive.html'), archivedOutput);
+
+
+  // Generate and minify 'archive.html' file
+  const minifiedArchivedOutput =  minify(archivedOutput, {
+      collapseBooleanAttributes: true,
+      collapseWhitespace: true,
+      decodeEntities: false,
+      minifyCSS: true,
+      minifyJS: true,
+      keepClosingSlash: true,
+      processConditionalComments: true,
+      removeAttributeQuotes: false,
+      removeComments: true,
+      removeEmptyAttributes: false,
+      removeOptionalTags: false,
+      removeScriptTypeAttributes: false,
+      removeStyleLinkTypeAttributes: false,
+      trimCustomFragments: true
+    });
+  fs.writeFileSync(path.join(docsPath, 'archive.html'), minifiedArchivedOutput);
   console.log(`${chalk.green('SUCCESS!')} archive.html file generated!`);
 
 } catch (err) {

From e61f08f47a005c789a7caf7872304f39814849bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stefan=20Feje=C5=A1?= 
Date: Sat, 7 Apr 2018 18:44:54 +0200
Subject: [PATCH 33/36] minification for beginner.html

---
 docs/beginner.html | 208 ++++++---------------------------------------
 docs/index.html    |  96 ++++++++++++++-------
 scripts/web.js     |  21 ++++-
 3 files changed, 108 insertions(+), 217 deletions(-)

diff --git a/docs/beginner.html b/docs/beginner.html
index 162c1f056..06f319cca 100644
--- a/docs/beginner.html
+++ b/docs/beginner.html
@@ -1,28 +1,4 @@
-
-
-  
-    
-    
-    
-    
-    Snippets for Beginners - 30 seconds of code
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    Snippets for Beginners - 30 seconds of code
-  
-  
-      
-    

-      
logo 30 seconds of code

-      
Curated collection of useful JavaScript snippets
 that you can understand in 30 seconds or less.

-      
-    

-    

-      

-        

-            
Snippets for Beginners

-            
The following section is aimed towards individuals who are at the start of their web developer journey. Each snippet in the next section is simple yet very educational for newcomers. This section is by no means a complete resource for learning modern JavaScript. However, it is enough to grasp some common concepts and use cases. We also strongly recommend checking out MDN web docs as a learning resource.


-        

-      

-
-
currentURL

-
Returns the current URL.

-
Use window.location.href to get current URL.

-
const currentURL = () => window.location.href;
+      }
logo 30 seconds of code
Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.
Snippets for Beginners
The following section is aimed towards individuals who are at the start of their web developer journey. Each snippet in the next section is simple yet very educational for newcomers. This section is by no means a complete resource for learning modern JavaScript. However, it is enough to grasp some common concepts and use cases. We also strongly recommend checking out MDN web docs as a learning resource.

currentURL
Returns the current URL.
Use window.location.href to get current URL.
const currentURL = () => window.location.href;
 
currentURL(); // 'https://google.com'
-

-
everyNth

-
Returns every nth element in an array.

-
Use Array.filter() to create a new array that contains every nth element of a given array.

-
const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
+
everyNth
Returns every nth element in an array.
Use Array.filter() to create a new array that contains every nth element of a given array.
const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
 
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
-

-
factorial

-
Calculates the factorial of a number.

-
Use recursion.
-If n is less than or equal to 1, return 1.
-Otherwise, return the product of n and the factorial of n - 1.
-Throws an exception if n is a negative number.

-
const factorial = n =>
+
factorial
Calculates the factorial of a number.
Use recursion. If n is less than or equal to 1, return 1. Otherwise, return the product of n and the factorial of n - 1. Throws an exception if n is a negative number.
const factorial = n =>
   n < 0
     ? (() => {
         throw new TypeError('Negative numbers are not allowed!');
       })()
     : n <= 1 ? 1 : n * factorial(n - 1);
 
factorial(6); // 720
-

-
fibonacci

-
Generates an array, containing the Fibonacci sequence, up until the nth term.

-
Create an empty array of the specific length, initializing the first two values (0 and 1).
-Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.

-
const fibonacci = n =>
+
fibonacci
Generates an array, containing the Fibonacci sequence, up until the nth term.
Create an empty array of the specific length, initializing the first two values (0 and 1). Use Array.reduce() to add values into the array, using the sum of the last two values, except for the first two.
const fibonacci = n =>
   Array.from({ length: n }).reduce(
     (acc, val, i) => acc.concat(i > 1 ? acc[i - 1] + acc[i - 2] : i),
     []
   );
 
fibonacci(6); // [0, 1, 1, 2, 3, 5]
-

-
filterNonUnique

-
Filters out the non-unique values in an array.

-
Use Array.filter() for an array containing only the unique values.

-
const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
+
filterNonUnique
Filters out the non-unique values in an array.
Use Array.filter() for an array containing only the unique values.
const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
 
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1,3,5]
-

-
gcd

-
Calculates the greatest common divisor between two or more numbers/arrays.

-
The inner _gcd function uses recursion.
-Base case is when y equals 0. In this case, return x.
-Otherwise, return the GCD of y and the remainder of the division x/y.

-
const gcd = (...arr) => {
+
gcd
Calculates the greatest common divisor between two or more numbers/arrays.
The inner _gcd function uses recursion. Base case is when y equals 0. In this case, return x. Otherwise, return the GCD of y and the remainder of the division x/y.
const gcd = (...arr) => {
   const _gcd = (x, y) => (!y ? x : gcd(y, x % y));
   return [...arr].reduce((a, b) => _gcd(a, b));
 };
 
gcd(8, 36); // 4
 gcd(...[12, 8, 32]); // 4
-

-
getMeridiemSuffixOfInteger

-
Converts an integer to a suffixed string, adding am or pm based on its value.

-
Use the modulo operator (%) and conditional checks to transform an integer to a stringified 12-hour format with meridiem suffix.

-
const getMeridiemSuffixOfInteger = num =>
+
getMeridiemSuffixOfInteger
Converts an integer to a suffixed string, adding am or pm based on its value.
Use the modulo operator (%) and conditional checks to transform an integer to a stringified 12-hour format with meridiem suffix.
const getMeridiemSuffixOfInteger = num =>
   num === 0 || num === 24
     ? 12 + 'am'
     : num === 12 ? 12 + 'pm' : num < 12 ? num % 12 + 'am' : num % 12 + 'pm';
@@ -164,133 +89,50 @@ Otherwise, return the GCD of y and the remainder of the division getMeridiemSuffixOfInteger(11); // "11am"
 getMeridiemSuffixOfInteger(13); // "1pm"
 getMeridiemSuffixOfInteger(25); // "1pm"
-

-
hasClass

-
Returns true if the element has the specified class, false otherwise.

-
Use element.classList.contains() to check if the element has the specified class.

-
const hasClass = (el, className) => el.classList.contains(className);
+
hasClass
Returns true if the element has the specified class, false otherwise.
Use element.classList.contains() to check if the element has the specified class.
const hasClass = (el, className) => el.classList.contains(className);
 
hasClass(document.querySelector('p.special'), 'special'); // true
-

-
isDivisible

-
Checks if the first numeric argument is divisible by the second one.

-
Use the modulo operator (%) to check if the remainder is equal to 0.

-
const isDivisible = (dividend, divisor) => dividend % divisor === 0;
+
isDivisible
Checks if the first numeric argument is divisible by the second one.
Use the modulo operator (%) to check if the remainder is equal to 0.
const isDivisible = (dividend, divisor) => dividend % divisor === 0;
 
isDivisible(6, 3); // true
-

-
isEven

-
Returns true if the given number is even, false otherwise.

-
Checks whether a number is odd or even using the modulo (%) operator.
-Returns true if the number is even, false if the number is odd.

-
const isEven = num => num % 2 === 0;
+
isEven
Returns true if the given number is even, false otherwise.
Checks whether a number is odd or even using the modulo (%) operator. Returns true if the number is even, false if the number is odd.
const isEven = num => num % 2 === 0;
 
isEven(3); // false
-

-
isPrime

-
Checks if the provided integer is a prime number.

-
Check numbers from 2 to the square root of the given number.
-Return false if any of them divides the given number, else return true, unless the number is less than 2.

-
const isPrime = num => {
+
isPrime
Checks if the provided integer is a prime number.
Check numbers from 2 to the square root of the given number. Return false if any of them divides the given number, else return true, unless the number is less than 2.
const isPrime = num => {
   const boundary = Math.floor(Math.sqrt(num));
   for (var i = 2; i <= boundary; i++) if (num % i === 0) return false;
   return num >= 2;
 };
 
isPrime(11); // true
-

-
last

-
Returns the last element in an array.

-
Use arr.length - 1 to compute the index of the last element of the given array and returning it.

-
const last = arr => arr[arr.length - 1];
+
last
Returns the last element in an array.
Use arr.length - 1 to compute the index of the last element of the given array and returning it.
const last = arr => arr[arr.length - 1];
 
last([1, 2, 3]); // 3
-

-
lcm

-
Returns the least common multiple of two or more numbers.

-
Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple.
-The GCD formula uses recursion.

-
const lcm = (...arr) => {
+
lcm
Returns the least common multiple of two or more numbers.
Use the greatest common divisor (GCD) formula and the fact that lcm(x,y) = x * y / gcd(x,y) to determine the least common multiple. The GCD formula uses recursion.
const lcm = (...arr) => {
   const gcd = (x, y) => (!y ? x : gcd(y, x % y));
   const _lcm = (x, y) => x * y / gcd(x, y);
   return [...arr].reduce((a, b) => _lcm(a, b));
 };
 
lcm(12, 7); // 84
 lcm(...[1, 3, 4, 5]); // 60
-

-
maxN

-
Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).

-
Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order.
-Use Array.slice() to get the specified number of elements.
-Omit the second argument, n, to get a one-element array.

-
const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
+
maxN
Returns the n maximum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in descending order).
Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in descending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.
const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
 
maxN([1, 2, 3]); // [3]
 maxN([1, 2, 3], 2); // [3,2]
-

-
minN

-
Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).

-
Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order.
-Use Array.slice() to get the specified number of elements.
-Omit the second argument, n, to get a one-element array.

-
const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
+
minN
Returns the n minimum elements from the provided array. If n is greater than or equal to the provided array's length, then return the original array(sorted in ascending order).
Use Array.sort() combined with the spread operator (...) to create a shallow clone of the array and sort it in ascending order. Use Array.slice() to get the specified number of elements. Omit the second argument, n, to get a one-element array.
const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
 
minN([1, 2, 3]); // [1]
 minN([1, 2, 3], 2); // [1,2]
-

-
nthElement

-
Returns the nth element of an array.

-
Use Array.slice() to get an array containing the nth element at the first place.
-If the index is out of bounds, return [].
-Omit the second argument, n, to get the first element of the array.

-
const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
+
nthElement
Returns the nth element of an array.
Use Array.slice() to get an array containing the nth element at the first place. If the index is out of bounds, return []. Omit the second argument, n, to get the first element of the array.
const nthElement = (arr, n = 0) => (n > 0 ? arr.slice(n, n + 1) : arr.slice(n))[0];
 
nthElement(['a', 'b', 'c'], 1); // 'b'
 nthElement(['a', 'b', 'b'], -3); // 'a'
-

-
randomIntegerInRange

-
Returns a random integer in the specified range.

-
Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.

-
const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+
randomIntegerInRange
Returns a random integer in the specified range.
Use Math.random() to generate a random number and map it to the desired range, using Math.floor() to make it an integer.
const randomIntegerInRange = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
 
randomIntegerInRange(0, 5); // 2
-

-
reverseString

-
Reverses a string.

-
Use the spread operator (...) and Array.reverse() to reverse the order of the characters in the string.
-Combine characters to get a string using String.join('').

-
const reverseString = str => [...str].reverse().join('');
+
reverseString
Reverses a string.
Use the spread operator (...) and Array.reverse() to reverse the order of the characters in the string. Combine characters to get a string using String.join('').
const reverseString = str => [...str].reverse().join('');
 
reverseString('foobar'); // 'raboof'
-

-
sample

-
Returns a random element from an array.

-
Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor().
-This method also works with strings.

-
const sample = arr => arr[Math.floor(Math.random() * arr.length)];
+
sample
Returns a random element from an array.
Use Math.random() to generate a random number, multiply it by length and round it of to the nearest whole number using Math.floor(). This method also works with strings.
const sample = arr => arr[Math.floor(Math.random() * arr.length)];
 
sample([3, 7, 9, 11]); // 9
-

-
similarity

-
Returns an array of elements that appear in both arrays.

-
Use Array.filter() to remove values that are not part of values, determined using Array.includes().

-
const similarity = (arr, values) => arr.filter(v => values.includes(v));
+
similarity
Returns an array of elements that appear in both arrays.
Use Array.filter() to remove values that are not part of values, determined using Array.includes().
const similarity = (arr, values) => arr.filter(v => values.includes(v));
 
similarity([1, 2, 3], [1, 2, 4]); // [1,2]
-

-
sum

-
Returns the sum of two or more numbers/arrays.

-
Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.

-
const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
+
sum
Returns the sum of two or more numbers/arrays.
Use Array.reduce() to add each value to an accumulator, initialized with a value of 0.
const sum = (...arr) => [...arr].reduce((acc, val) => acc + val, 0);
 
sum(...[1, 2, 3, 4]); // 10
-

-
tail

-
Returns all elements in an array except for the first one.

-
Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.

-
const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
+
tail
Returns all elements in an array except for the first one.
Return Array.slice(1) if the array's length is more than 1, otherwise, return the whole array.
const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
 
tail([1, 2, 3]); // [2,3]
 tail([1]); // [1]
-

-
truncateString

-
Truncates a string up to a specified length.

-
Determine if the string's length is greater than num.
-Return the string truncated to the desired length, with '...' appended to the end or the original string.

-
const truncateString = (str, num) =>
+
truncateString
Truncates a string up to a specified length.
Determine if the string's length is greater than num. Return the string truncated to the desired length, with '...' appended to the end or the original string.
const truncateString = (str, num) =>
   str.length > num ? str.slice(0, num > 3 ? num - 3 : num) + '...' : str;
 
truncateString('boomerang', 7); // 'boom...'
-

-
    

-    

-    
-    

-    
-  
-
+

\ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 8ce2b51d1..a85fa3212 100644 --- a/docs/index.html +++ b/docs/index.html @@ -76,39 +76,71 @@
-

get

-

Retrieve a set of properties indicated by the given selectors from an object.

-

Use Array.map() for each selector, String.replace() to replace square brackets with dots, String.split('.') to split each selector, Array.filter() to remove empty values and Array.reduce() to get the value indicated by it.

-
const get = (from, ...selectors) =>
-  [...selectors].map(s =>
-    s
-      .replace(/\[([^\[\]]*)\]/g, '.$1.')
-      .split('.')
-      .filter(t => t !== '')
-      .reduce((prev, cur) => prev && prev[cur], from)
+      
binomialCoefficient

+
Evaluates the binomial coefficient of two integers n and k.

+
Use Number.isNaN() to check if any of the two values is NaN.
+Check if k is less than 0, greater than or equal to n, equal to 1 or n - 1 and return the appropriate result.
+Check if n - k is less than k and switch their values accordingly.
+Loop from 2 through k and calculate the binomial coefficient.
+Use Math.round() to account for rounding errors in the calculation.

+
const binomialCoefficient = (n, k) => {
+  if (Number.isNaN(n) || Number.isNaN(k)) return NaN;
+  if (k < 0 || k > n) return 0;
+  if (k === 0 || k === n) return 1;
+  if (k === 1 || k === n - 1) return n;
+  if (n - k < k) k = n - k;
+  let res = n;
+  for (let j = 2; j <= k; j++) res *= (n - j + 1) / j;
+  return Math.round(res);
+};
+
binomialCoefficient(8, 2); // 28
+

+
isTravisCI

+
Checks if the current environment is Travis CI.

+
Checks if the current environment has the TRAVIS and CI environment variables (reference).

+
const isTravisCI = () => 'TRAVIS' in process.env && 'CI' in process.env;
+
isTravisCI(); // true (if code is running on Travis CI)
+

+
runAsync

+
Runs a function in a separate thread by using a Web Worker, allowing long running functions to not block the UI.

+
Create a new Worker using a Blob object URL, the contents of which should be the stringified version of the supplied function.
+Immediately post the return value of calling the function back.
+Return a promise, listening for onmessage and onerror events and resolving the data posted back from the worker, or throwing an error.

+
const runAsync = fn => {
+  const worker = new Worker(
+    URL.createObjectURL(new Blob([`postMessage((${fn})());`]), {
+      type: 'application/javascript; charset=utf-8'
+    })
   );
-
const obj = { selector: { to: { val: 'val to select' } }, target: [1, 2, { a: 'test' }] };
-get(obj, 'selector.to.val', 'target[0]', 'target[2].a'); // ['val to select', 1, 'test']
-

-
toDecimalMark

-
Use toLocaleString() to convert a float-point arithmetic to the Decimal mark form. It makes a comma separated string from a number.

-
const toDecimalMark = num => num.toLocaleString('en-US');
-
toDecimalMark(12305030388.9087); // "12,305,030,388.909"
-

-
toKebabCase

-
Converts a string to kebab case.

-
Break the string into words and combine them adding - as a separator, using a regexp.

-
const toKebabCase = str =>
-  str &&
-  str
-    .match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)
-    .map(x => x.toLowerCase())
-    .join('-');
-
toKebabCase('camelCase'); // 'camel-case'
-toKebabCase('some text'); // 'some-text'
-toKebabCase('some-mixed_string With spaces_underscores-and-hyphens'); // 'some-mixed-string-with-spaces-underscores-and-hyphens'
-toKebabCase('AllThe-small Things'); // "all-the-small-things"
-toKebabCase('IAmListeningToFMWhileLoadingDifferentURLOnMyBrowserAndAlsoEditingSomeXMLAndHTML'); // "i-am-listening-to-fm-while-loading-different-url-on-my-browser-and-also-editing-xml-and-html"
+  return new Promise((res, rej) => {
+    worker.onmessage = ({ data }) => {
+      res(data), worker.terminate();
+    };
+    worker.onerror = err => {
+      rej(err), worker.terminate();
+    };
+  });
+};
+
const longRunningFunction = () => {
+  let result = 0;
+  for (let i = 0; i < 1000; i++) {
+    for (let j = 0; j < 700; j++) {
+      for (let k = 0; k < 300; k++) {
+        result = result + i + j + k;
+      }
+    }
+  }
+  return result;
+};
+/*
+  NOTE: Since the function is running in a different context, closures are not supported.
+  The function supplied to `runAsync` gets stringified, so everything becomes literal.
+  All variables and functions must be defined inside.
+*/
+runAsync(longRunningFunction).then(console.log); // 209685000000
+runAsync(() => 10 ** 3).then(console.log); // 1000
+let outsideVariable = 50;
+runAsync(() => typeof outsideVariable).then(console.log); // 'undefined'
 

 

       

diff --git a/scripts/web.js b/scripts/web.js
index e81a6c840..5b8103bbf 100644
--- a/scripts/web.js
+++ b/scripts/web.js
@@ -273,8 +273,24 @@ try {
 
   beginnerOutput += `${beginnerEndPart}`;
 
-  // Generate 'beginner.html' file
-  fs.writeFileSync(path.join(docsPath, 'beginner.html'), beginnerOutput);
+  // Generate and minify 'beginner.html' file
+  const minifiedBeginnerOutput =  minify(beginnerOutput, {
+    collapseBooleanAttributes: true,
+    collapseWhitespace: true,
+    decodeEntities: false,
+    minifyCSS: true,
+    minifyJS: true,
+    keepClosingSlash: true,
+    processConditionalComments: true,
+    removeAttributeQuotes: false,
+    removeComments: true,
+    removeEmptyAttributes: false,
+    removeOptionalTags: false,
+    removeScriptTypeAttributes: false,
+    removeStyleLinkTypeAttributes: false,
+    trimCustomFragments: true
+  });
+  fs.writeFileSync(path.join(docsPath, 'beginner.html'), minifiedBeginnerOutput);
   console.log(`${chalk.green('SUCCESS!')} beginner.html file generated!`);
 
 } catch (err) {
@@ -341,6 +357,7 @@ try {
       removeStyleLinkTypeAttributes: false,
       trimCustomFragments: true
     });
+
   fs.writeFileSync(path.join(docsPath, 'archive.html'), minifiedArchivedOutput);
   console.log(`${chalk.green('SUCCESS!')} archive.html file generated!`);
 

From c7510d93be0f46519b8606efe1f99ca4e4ff6c82 Mon Sep 17 00:00:00 2001
From: Angelos Chalaris 
Date: Sat, 7 Apr 2018 19:56:40 +0300
Subject: [PATCH 34/36] Updated web script to run uninhibited on Travis

Uses the environment's GH_KEY hopefully.
---
 docs/archive.html  |  2 +-
 docs/beginner.html |  2 +-
 docs/index.html    | 56 +++++++++++++++++++---------------------------
 scripts/web.js     | 10 ++++++++-
 4 files changed, 34 insertions(+), 36 deletions(-)

diff --git a/docs/archive.html b/docs/archive.html
index e841ac185..d4e97f0ec 100644
--- a/docs/archive.html
+++ b/docs/archive.html
@@ -10,7 +10,7 @@
       gtag('config', 'UA-117141635-1');
     
     
-    Snippets for Beginners - 30 seconds of code
+    Snippets Archive - 30 seconds of code
     
     
     
diff --git a/docs/beginner.html b/docs/beginner.html
index 101a5db4c..162c1f056 100644
--- a/docs/beginner.html
+++ b/docs/beginner.html
@@ -93,7 +93,7 @@
     

       

         

-            
Beginner snippets

+            
Snippets for Beginners

             
The following section is aimed towards individuals who are at the start of their web developer journey. Each snippet in the next section is simple yet very educational for newcomers. This section is by no means a complete resource for learning modern JavaScript. However, it is enough to grasp some common concepts and use cases. We also strongly recommend checking out MDN web docs as a learning resource.


         

       

diff --git a/docs/index.html b/docs/index.html
index 3fd8cfb4e..db7503e7e 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -76,42 +76,32 @@
       

         
       
-      
createElement

-
Creates an element from a string (without appending it to the document).
-If the given string contains multiple elements, only the first one will be returned.

-
Use document.createElement() to create a new element.
-Set its innerHTML to the string supplied as the argument.
-Use ParentNode.firstElementChild to return the element version of the string.

-
const createElement = str => {
-  const el = document.createElement('div');
-  el.innerHTML = str;
-  return el.firstElementChild;
+      
difference

+
Returns the difference between two arrays.

+
Create a Set from b, then use Array.filter() on a to only keep values not contained in b.

+
const difference = (a, b) => {
+  const s = new Set(b);
+  return a.filter(x => !s.has(x));
 };
-
const el = createElement(
-  `<div class="container">
-    <p>Hello!</p>
-  </div>`
-);
-console.log(el.className); // 'container'
+
difference([1, 2, 3], [1, 2, 4]); // [3]
 

-
isSymbol

-
Checks if the given argument is a symbol.

-
Use typeof to check if a value is classified as a symbol primitive.

-
const isSymbol = val => typeof val === 'symbol';
-
isSymbol(Symbol('x')); // true
+
hasFlags

+
Check if the current process's arguments contain the specified flags.

+
Use Array.every() and Array.includes() to check if process.argv contains all the specified flags.
+Use a regular expression to test if the specified flags are prefixed with - or -- and prefix them accordingly.

+
const hasFlags = (...flags) =>
+  flags.every(flag => process.argv.includes(/^-{1,2}/.test(flag) ? flag : '--' + flag));
+
// node myScript.js -s --test --cool=true
+hasFlags('-s'); // true
+hasFlags('--test', 'cool=true', '-s'); // true
+hasFlags('special'); // false
 

-
scrollToTop

-
Smooth-scrolls to the top of the page.

-
Get distance from top using document.documentElement.scrollTop or document.body.scrollTop.
-Scroll by a fraction of the distance from the top. Use window.requestAnimationFrame() to animate the scrolling.

-
const scrollToTop = () => {
-  const c = document.documentElement.scrollTop || document.body.scrollTop;
-  if (c > 0) {
-    window.requestAnimationFrame(scrollToTop);
-    window.scrollTo(0, c - c / 8);
-  }
-};
-
scrollToTop();
+
isPlainObject

+
Checks if the provided value is an object created by the Object constructor.

+
Check if the provided value is truthy, use typeof to check if it is an object and Object.constructor to make sure the constructor is equal to Object.

+
const isPlainObject = val => !!val && typeof val === 'object' && val.constructor === Object;
+
isPlainObject({ a: 1 }); // true
+isPlainObject(new Map()); // false
 

 

       

diff --git a/scripts/web.js b/scripts/web.js
index 93f3c0406..472b3e361 100644
--- a/scripts/web.js
+++ b/scripts/web.js
@@ -132,7 +132,15 @@ if(!util.isTravisCI() || (util.isTravisCI() && (process.env['TRAVIS_EVENT_TYPE']
     indexStaticFile = indexStaticFile.replace('$daily-picks',indexDailyPicks);
     // Use the Github API to get the needed data
     const githubApi = 'api.github.com';
-    const headers = { 'User-Agent' : '30-seconds-of-code'};
+    const headers = util.isTravisCI()
+      ? { 'User-Agent' : '30-seconds-of-code', 'Authorization': 'token '+process.env['GH_TOKEN']}
+      : { 'User-Agent' : '30-seconds-of-code'};
+    // Test the API's rate limit (keep for various reasons)
+    https.get({host: githubApi, path: '/rate_limit?', headers: headers}, res =>{
+      res.on('data', function (chunk) {
+          console.log('Remaining requests: '+JSON.parse(chunk).resources.core.remaining);
+      });
+    });
     // Send requests and wait for responses, write to the page
     https.get({host: githubApi, path: '/repos/chalarangelo/30-seconds-of-code/commits?per_page=1', headers: headers}, resCommits =>{
       https.get({host: githubApi, path: '/repos/chalarangelo/30-seconds-of-code/contributors?per_page=1', headers: headers}, resContributors => {

From cf26f197ea13aa9740675909f2fb025729b797d2 Mon Sep 17 00:00:00 2001
From: Angelos Chalaris 
Date: Sat, 7 Apr 2018 20:06:14 +0300
Subject: [PATCH 35/36] Updated footers

---
 static-parts/archived-page-end.html | 2 +-
 static-parts/beginner-page-end.html | 2 +-
 static-parts/index.html             | 2 +-
 static-parts/page-end.html          | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/static-parts/archived-page-end.html b/static-parts/archived-page-end.html
index a2f9630f0..75e07cd15 100644
--- a/static-parts/archived-page-end.html
+++ b/static-parts/archived-page-end.html
@@ -2,6 +2,6 @@
 

 
 

-
+
 
 
diff --git a/static-parts/beginner-page-end.html b/static-parts/beginner-page-end.html
index d6eafb24f..0b7d71155 100644
--- a/static-parts/beginner-page-end.html
+++ b/static-parts/beginner-page-end.html
@@ -2,6 +2,6 @@
     

     
     

-    
+    
   
 
diff --git a/static-parts/index.html b/static-parts/index.html
index dcf1f9fc6..5633b5258 100644
--- a/static-parts/index.html
+++ b/static-parts/index.html
@@ -189,7 +189,7 @@
   

 

 

-
+
 
-    
-    
-    30 seconds of code
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-  
-  
-    
-    

-  
logo 30 seconds of code

-  
Curated collection of useful JavaScript snippets
 that you can understand in 30 seconds or less.

-  
-

-

-  

-    

-      

-        
-        
295
snippets

-      

-      

-        
-        
113
contributors

-      

-      

-        
-        
3029
commits

-      

-      

-        
-        
19461
stars

-      

-    

-  

-

-

-  

-    

-      
Our philosophy

-      
The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.


-    

-  

-  

-    

-      

-        

-          

-          

-          
In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

-        

-      


-    

-  

-  

-    

-      
Today's picks

-      
Our sophisticated robot helpers pick new snippets from our collection daily, so that you can discover new snippets to enhance your projects:

-      

-        
-      
-      
binomialCoefficient

-
Evaluates the binomial coefficient of two integers n and k.

-
Use Number.isNaN() to check if any of the two values is NaN.
-Check if k is less than 0, greater than or equal to n, equal to 1 or n - 1 and return the appropriate result.
-Check if n - k is less than k and switch their values accordingly.
-Loop from 2 through k and calculate the binomial coefficient.
-Use Math.round() to account for rounding errors in the calculation.

-
const binomialCoefficient = (n, k) => {
-  if (Number.isNaN(n) || Number.isNaN(k)) return NaN;
-  if (k < 0 || k > n) return 0;
-  if (k === 0 || k === n) return 1;
-  if (k === 1 || k === n - 1) return n;
-  if (n - k < k) k = n - k;
-  let res = n;
-  for (let j = 2; j <= k; j++) res *= (n - j + 1) / j;
-  return Math.round(res);
+30 seconds of code
logo 30 seconds of code
Curated collection of useful JavaScript snippets
that you can understand in 30 seconds or less.
295
snippets
113
contributors
3029
commits
19461
stars
Our philosophy
The core goal of 30 seconds of code is to provide a quality resource for beginner and advanced JavaScript developers alike. We want to help improve the JavaScript ecosystem, by lowering the barrier of entry for newcomers and help seasoned veterans pick up new tricks and remember old ones. In order to achieve this, we have collected hundreds of snippets that can be of use in a wide range of situations. We welcome new contributors and we like fresh ideas, as long as the code is short and easy to grasp in about 30 seconds. The only catch, if you may, is that many of our snippets are not perfectly suited for large, enterprise applications and they might not be deemed production-ready.

In order for 30 seconds of code to be as accessible and useful as possible, all of the snippets in the collection are licensed under the CC0-1.0 License, meaning they are absolutely free to use in any project you like. If you like what we do, you can always credit us, but that is not mandatory.

Today's picks
Our sophisticated robot helpers pick new snippets from our collection daily, so that you can discover new snippets to enhance your projects:
 
compose
Performs right-to-left function composition.
Use Array.reduce() to perform right-to-left function composition. The last (rightmost) function can accept one or more arguments; the remaining functions must be unary.
const compose = (...fns) => fns.reduce((f, g) => (...args) => f(g(...args)));
+
const add5 = x => x + 5;
+const multiply = (x, y) => x * y;
+const multiplyAndAdd5 = compose(add5, multiply);
+multiplyAndAdd5(5, 2); // 15
+
deepFlatten
Deep flattens an array.
Use recursion. Use Array.concat() with an empty array ([]) and the spread operator (...) to flatten an array. Recursively flatten each element that is an array.
const deepFlatten = arr => [].concat(...arr.map(v => (Array.isArray(v) ? deepFlatten(v) : v)));
+
deepFlatten([1, [2], [[3], 4], 5]); // [1,2,3,4,5]
+
palindrome
Returns true if the given string is a palindrome, false otherwise.
Convert string String.toLowerCase() and use String.replace() to remove non-alphanumeric characters from it. Then, String.split('') into individual characters, Array.reverse(), String.join('') and compare to the original, unreversed string, after converting it String.tolowerCase().
const palindrome = str => {
+  const s = str.toLowerCase().replace(/[\W_]/g, '');
+  return (
+    s ===
+    s
+      .split('')
+      .reverse()
+      .join('')
+  );
 };
-
binomialCoefficient(8, 2); // 28
-

-
isTravisCI

-
Checks if the current environment is Travis CI.

-
Checks if the current environment has the TRAVIS and CI environment variables (reference).

-
const isTravisCI = () => 'TRAVIS' in process.env && 'CI' in process.env;
-
isTravisCI(); // true (if code is running on Travis CI)
-

-
runAsync

-
Runs a function in a separate thread by using a Web Worker, allowing long running functions to not block the UI.

-
Create a new Worker using a Blob object URL, the contents of which should be the stringified version of the supplied function.
-Immediately post the return value of calling the function back.
-Return a promise, listening for onmessage and onerror events and resolving the data posted back from the worker, or throwing an error.

-
const runAsync = fn => {
-  const worker = new Worker(
-    URL.createObjectURL(new Blob([`postMessage((${fn})());`]), {
-      type: 'application/javascript; charset=utf-8'
-    })
-  );
-  return new Promise((res, rej) => {
-    worker.onmessage = ({ data }) => {
-      res(data), worker.terminate();
-    };
-    worker.onerror = err => {
-      rej(err), worker.terminate();
-    };
-  });
-};
-
const longRunningFunction = () => {
-  let result = 0;
-  for (let i = 0; i < 1000; i++) {
-    for (let j = 0; j < 700; j++) {
-      for (let k = 0; k < 300; k++) {
-        result = result + i + j + k;
-      }
-    }
-  }
-  return result;
-};
-/*
-  NOTE: Since the function is running in a different context, closures are not supported.
-  The function supplied to `runAsync` gets stringified, so everything becomes literal.
-  All variables and functions must be defined inside.
-*/
-runAsync(longRunningFunction).then(console.log); // 209685000000
-runAsync(() => 10 ** 3).then(console.log); // 1000
-let outsideVariable = 50;
-runAsync(() => typeof outsideVariable).then(console.log); // 'undefined'
-

-

-      

-    

-    

-  

-

-

-  

-    

-      
Getting started

-      

-    

-  

-  

-    

-      
Related projects

-      
The idea behind 30 seconds of code has inspired some people to create similar collections in other programming languages and environments. Here are the ones we like the most:

-      

-    

-  

-  

-    

-      
Top contributors

-      

-        

-          chalarangelo
-          Angelos Chalaris
-          

-        

-        

-          fejes713
-          Stefan Feješ
-          

-        

-          flxwu
-          Felix Wu
-          

-        

-          atomiks
-          atomiks
-          

-        

-          kingdavidmartins
-          King David Martins
-          

-        

-          kriadmin
-          Rohit Tanwar
-          

-        

-          iamsoorena
-          Soorena Soleimani
-          

-        

-          skatcat31
-          Robert Mennell
-          

-    

-    

-  

-  

-    

-      
How to contribute

-      
Do you have a cool idea for a new snippet? Maybe some code you use often and is not part of our collection? Contributing to 30 seconds of code is as simple as 1,2,3,4!

-          

-            1
-            

-              
Create

-              
Start by creating a snippet, according to the snippet template. Make sure to follow these simple guidelines:

-              
    
-                
  • Your snippet title must be unique and the same as the name of the implemented function.
    • 
-                
  • Use the snippet description to explain what your snippet does and how it works.
    • 
-                
  • Try to keep the snippet's code short and to the point. Use modern techniques and features.
    • 
-                
  • Remember to provide an example of how your snippet works.
    • 
-                
  • Your snippet should solve a real-world problem, no matter how simple.
    • 
-                
  • Never modify README.md or any of the HTML files.
    • 
-              

-            

-          

-          

-            2
-            

-              
Tag

-              
Run npm run tagger from your terminal, then open the tag_database file and tag your snippet appropriately. Multitagging is also supported, just make sure the first tag you specify is on of the major tags and the one that is most relevant to the implemneted function.

-            

-          

-          

-            3
-            

-              
Test

-              
You can optionally test your snippet to make our job easier. Simply run npm run tester to generate the test files for your snippet. Find the related folder for you snippet under the test directory and write some tests. Remember to run npm run tester again to make sure your tests are passing.

-            

-          

-          

-            4
-            

-              
Pull request

-              
If you have done everything mentioned above, you should now have an awesome snippet to add to our collection. Simply start a pull request and follow the guidelines provided. Remember to only submit one snippet per pull request, so that we can quickly evaluate and merge your code into the collection.

-            

-          

-  
If you need additional pointers about writing a snippet, be sure to read the complete contribution guidelines.

-        

-  

-

-

-
-
-
-
+};
\ No newline at end of file
diff --git a/docs/math.html b/docs/math.html
index 7897cb4c0..f7acff94e 100644
--- a/docs/math.html
+++ b/docs/math.html
@@ -272,4 +272,4 @@ own individual rating by supplying it as the third argument.
   Math.round(Math.max(Math.min(num, Number.MAX_SAFE_INTEGER), Number.MIN_SAFE_INTEGER));
 
toSafeInteger('3.2'); // 3
 toSafeInteger(Infinity); // 9007199254740991
-

\ No newline at end of file
+
\ No newline at end of file diff --git a/docs/node.html b/docs/node.html index 02c227a18..3f98383fa 100644 --- a/docs/node.html +++ b/docs/node.html @@ -151,4 +151,4 @@ console.log< (c ^ (crypto.randomBytes(1)[0] & (15 >> (c / 4)))).toString(16) ); 
UUIDGeneratorNode(); // '79c7c136-60ee-40a2-beb2-856f1feabefc'
-
\ No newline at end of file + \ No newline at end of file diff --git a/docs/object.html b/docs/object.html index 006298a4f..ce9c7460d 100644 --- a/docs/object.html +++ b/docs/object.html @@ -329,4 +329,4 @@ Foo.prototypereturn acc; }, {}); 
unflattenObject({ 'a.b.c': 1, d: 1 }); // { a: { b: { c: 1 } }, d: 1 }
-
\ No newline at end of file + \ No newline at end of file diff --git a/docs/string.html b/docs/string.html index 4217f04a3..1f22cdf4d 100644 --- a/docs/string.html +++ b/docs/string.html @@ -258,4 +258,4 @@

words

Converts a given string into an array of words.

Use String.split() with a supplied pattern (defaults to non-alpha as a regexp) to convert to an array of strings. Use Array.filter() to remove any empty strings. Omit the second argument to use the default regexp.

const words = (str, pattern = /[^a-zA-Z-]+/) => str.split(pattern).filter(Boolean);
 
words('I love javaScript!!'); // ["I", "love", "javaScript"]
 words('python, javaScript & coffee'); // ["python", "javaScript", "coffee"]
-
\ No newline at end of file + \ No newline at end of file diff --git a/docs/type.html b/docs/type.html index e70353aa6..d79b0c8c7 100644 --- a/docs/type.html +++ b/docs/type.html @@ -178,4 +178,4 @@ 
isValidJSON('{"name":"Adam","age":20}'); // true
 isValidJSON('{"name":"Adam",age:"20"}'); // false
 isValidJSON(null); // true
-
\ No newline at end of file + \ No newline at end of file diff --git a/docs/utility.html b/docs/utility.html index 7a7d9e905..fc656d644 100644 --- a/docs/utility.html +++ b/docs/utility.html @@ -269,4 +269,4 @@ Logs: { yesNo('yes'); // true yesNo('No'); // false yesNo('Foo', true); // true - \ No newline at end of file + \ No newline at end of file diff --git a/scripts/web.js b/scripts/web.js index e52df1529..101f0d976 100644 --- a/scripts/web.js +++ b/scripts/web.js @@ -149,6 +149,22 @@ if(!util.isTravisCI() || (util.isTravisCI() && (process.env['TRAVIS_EVENT_TYPE'] contribs = resContributors.headers.link.split('&').slice(-1)[0].replace(/[^\d]/g,''), stars = resStars.headers.link.split('&').slice(-1)[0].replace(/[^\d]/g,''); indexStaticFile = indexStaticFile.replace(/\$snippet-count/g, Object.keys(snippets).length).replace(/\$commit-count/g,commits).replace(/\$contrib-count/g,contribs).replace(/\$star-count/g,stars); + indexStaticFile = minify(indexStaticFile, { + collapseBooleanAttributes: true, + collapseWhitespace: true, + decodeEntities: false, + minifyCSS: true, + minifyJS: true, + keepClosingSlash: true, + processConditionalComments: true, + removeAttributeQuotes: false, + removeComments: true, + removeEmptyAttributes: false, + removeOptionalTags: false, + removeScriptTypeAttributes: false, + removeStyleLinkTypeAttributes: false, + trimCustomFragments: true + }); // Generate 'index.html' file fs.writeFileSync(path.join(docsPath, 'index.html'), indexStaticFile); console.log(`${chalk.green('SUCCESS!')} index.html file generated!`); diff --git a/static-parts/index.html b/static-parts/index.html index 5633b5258..7db80bafe 100644 --- a/static-parts/index.html +++ b/static-parts/index.html @@ -109,36 +109,36 @@

Top contributors

- chalarangelo + chalarangelo Angelos Chalaris
- fejes713 + fejes713 Stefan Feješ
- flxwu + flxwu Felix Wu
- atomiks + atomiks atomiks
- kingdavidmartins + kingdavidmartins King David Martins
- kriadmin + kriadmin Rohit Tanwar
- iamsoorena + iamsoorena Soorena Soleimani
- skatcat31 + skatcat31 Robert Mennell
@@ -199,7 +199,7 @@ window.onload = function(){ runCounter(counters[1],0,values[1],steps[1]); runCounter(counters[2],0,values[2],steps[2]); runCounter(counters[3],0,values[3],steps[3]); - document.querySelector('button.next').addEventListener('click', e => { + document.querySelector('button.next').addEventListener('click', function(e){ let selected = document.getElementById('pick-slider').querySelector('.selected'); if(selected == Array.from(document.querySelectorAll('.card.fluid.pick')).slice(-1)[0]) { @@ -211,7 +211,7 @@ window.onload = function(){ selected.className = 'card fluid pick'; }); - document.querySelector('button.previous').addEventListener('click', e => { + document.querySelector('button.previous').addEventListener('click', function(e){ let selected = document.getElementById('pick-slider').querySelector('.selected'); if(selected == document.querySelector('.card.fluid.pick')) { @@ -248,7 +248,7 @@ window.onload = function(){ }, false); } -const runCounter = (selector, start, end, increment = 1, duration = 2000) => { +function runCounter(selector, start, end, increment = 1, duration = 2000){ let current = start, step = end > start ? increment : -increment, timer = setInterval(function() { @@ -259,7 +259,7 @@ const runCounter = (selector, start, end, increment = 1, duration = 2000) => { }, Math.abs(Math.floor(duration / (end - start)))); }; -const elementIsVisibleInViewport = (el, partiallyVisible = false) => { +function elementIsVisibleInViewport(el, partiallyVisible = false) { const { top, left, bottom, right } = el.getBoundingClientRect(); const { innerHeight, innerWidth } = window; return partiallyVisible