Restore the previous CEL object value and return the celestra object to create a new alias.

Tip: You can make a new alias without this function too. Example: globalThis._cel = globalThis.celestra;

In the ESM edition only returns the celestra object.

CEL.createPolyfillMethod(Array.prototype, "at", function(...){...});

A promise based delay function. The ms parameter is mandatory and have to be an integer (milliseconds).

Sample:

try

CEL.delay(5000)
  .then(() => alert("5 seconds"))
  .catch(console.log.bind(console))
  .finally(() => alert("done"));

If the newchar is undefined, then returns the unicode character, which has to be on the given index in the string. The index can be negative value (-1 -> last). If the index is out of the string length, then the return value is an empty string. All of the parameters are mandatory and index has to be an integer.

If the newChar is not undefined, then the indexed character will be replaced with the newChar and returns the modified string.

Stability: 4 - Stable.
Create and save file without a server. The filename and content parameters are mandatory and have to be a string. The dataType parameter is optional and can be a string. The default value of the dataType parameter is text/plain.

Doesn't work in iOS browsers (Safari, Firefox and Chrome) and W10M Edge 14.

Since v2.0.5, a new element can be created with an object. In this case the element descriptive object is mandatory. The style can be a subobject or a string.

Sample code:

CEL.domCreate({
  elementType: "a",
  href: "https://developer.mozilla.org/en-US/",
  target: "_blank",
  style: {
    "background-color": "red",
    "color": "white"
  },
  innerHTML: "MDN Sample url"
});

Load JavaScript files. The first parameter is mandatory and has to be a string. The other parameters are optional and can be a string.

Tip:
To prevent the caching of a js/css file use versioning in the file url. Example: mylib.js?version=1.10.0

For other node types (document, text, comment, etc.) checking please read this MDN page:
https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeType

Clear all of the cookies. The return value (boolean) is determines whether the cookie was set with the name before the removing.

Function parameters:

• The path is optional and can be a string. (Default value: "/") To the local path set the "" value!
• The domain is optional and can be a string.
• The secure is optional and can be a boolean.
• The SameSite is optional and can be a string. ("Lax", "Strict", "None", default value: "Lax")
• The HttpOnly is optional and can be a boolean.

Remove a cookie. The return value (boolean) is determines whether the cookie was set with the name before the removing.

Function parameters:

• The name is mandatory and has to be a string.
• The path is optional and can be a string. (Default value: "/") To the local path set the "" value!
• The domain is optional and can be a string.
• The secure is optional and can be a boolean.
• The SameSite is optional and can be a string. ("Lax", "Strict", "None", default value: "Lax")
• The HttpOnly is optional and can be a boolean.

The return value (boolean) is determines whether the cookie was set with the name before the removing.

Set a cookie.

Function parameters:

• The name is mandatory and has to be a string.
• The value is mandatory and has to be a string.
• The hours is the expire value and optional and can be a number. (Default value: 8760 = 1 year)
• The path is optional and can be a string. (Default value: "/") To the local path set the "" value!
• The domain is optional and can be a string.
• The secure is optional and can be a boolean.
• The SameSite is optional and can be a string. ("Lax", "Strict", "None", default value: "Lax")
• The HttpOnly is optional and can be a boolean.

Yield generated pairs (arrays) from the elements of a iterator and a counter. The iterator parameter is mandatory. The offset parameter is optional and can be an integer and it's default value is 0.

Example: CEL.enumerate(["Picard", "Riker", "Data"], 2); -> [2, "Picard"], [3, "Riker"], [4, "Data"]

Returns an array with the values of the given iterator, but without the last value.

Example:
CEL.initial([-5, 2, -9, 7, 34]);
->
[-5, 2, -9, 7]

Yield the items of an iterator over and over. The iter parameter is mandatory and the n parameter is optional and can be an integer. Default parameter value: n = Infinity

Note: PLease don't use with infinite iterators!

Returns an array, with filtered and negative filtered groups of the elements of the original iterator. All of the parameters are mandatory.

Example:
CEL.partition([-5, 2, -9, 7, 34], (e) => (e > 0) );
->
[[2, 7, 34], [-5, -9]]

Returns an array with the values of the given iterator, but in shuffled order.

Example:
CEL.shuffle(["first",4,5,6,7,8,9,"last"]);
->
[4,8,5,6,"last",9,7,"first"]

Stability: 4 - Stable.

This function returns a new iterator with unique values. The iterator parameter is mandatory.

The resolver parameter can be an object field name or function.

Examples

Without resolver:

JSON.stringify( CEL.unique( [1, 2, 2, 3] ) );
// '[1,2,3]'
        

With resolver:

let array = [
  { "name": "Picard", "rank": "captain" },
  { "name": "Riker", "rank": "captain" },
  { "name": "Data", "rank": "commander" },
  { "name": "Troi", "rank": "commander" }
];

// key resolver
JSON.stringify( CEL.unique(array, "rank") );
// '[{"name":"Picard","rank":"captain"},{"name":"Data","rank":"commander"}]'

// function resolver
JSON.stringify( CEL.unique(array, (v) => v.rank) );
// '[{"name":"Picard","rank":"captain"},{"name":"Data","rank":"commander"}]'
        

Returns an array with the values of the first iterator, but without the values of the filterIterator. All of the parameters are mandatory.

Example:
CEL.withOut(["a","b","c","d"], ["b","d"]);
->
["a","c"]

This function is based on this proposal:
https://github.com/tc39/proposal-Math.signbit

Returns whether the sign bit of x is set.
If n is NaN, the result is false.
If n is -0, the result is true.
If n is negative, the result is true.
Otherwise, the result is false.

The value parameter is mandatory.

Try

CEL.qs("#div2").append( CEL.domToElement("divHello world!/div") );

Try

CEL.qs("#div2").append( CEL.domToElement("pspan style=\"background-color: yellow; color: blue;\"Hello/span span style=\"background-color: blue; color: yellow;\"world/span!/p") );

var el1 = CEL.domCreate("h3", {style: {"background-color": "lightblue", "font-weight": "bold"}}, "H3 Lorem ipsum with style object");
var el2 = CEL.domCreate("p", {}, "Sample created paragraph");
var el3 = CEL.domCreate("br");
var el4 = CEL.domCreate("a", {href: "https://developer.mozilla.org/en-US/", target: "_blank", style: { "background-color": "red", "color": "white"}}, "MDN Sample url");
CEL.qs("#div2").append(el1);
el2.append(el3);
el2.append(el4);
CEL.qs("#div2").append(el2);

var el1 = CEL.domCreate("h3", {style: {"background-color": "lightblue", "font-weight": "bold"}}, "H3 Lorem ipsum with style string");
var el2 = CEL.domCreate("p", {}, "Sample created paragraph");
var el3 = CEL.domCreate("br");
var el4 = CEL.domCreate("a", {href: "https://developer.mozilla.org/en-US/", target: "_blank", style: "background-color: red; color: white;"}, "MDN Sample url");
CEL.qs("#div2").append(el1);
el2.append(el3);
el2.append(el4);
CEL.qs("#div2").append(el2);

var el1 = CEL.domCreate({elementType: "h3", style: {"background-color": "lightblue", "font-weight": "bold"}, innerHTML: "H3 Lorem ipsum from object with style object"});
var el2 = CEL.domCreate({elementType: "p", innerHTML: "Sample created paragraph"});
var el3 = CEL.domCreate("br");
var el4 = CEL.domCreate({elementType: "a", href: "https://developer.mozilla.org/en-US/", target: "_blank", style: {"background-color": "red", "color": "white"}, innerHTML: "MDN Sample url"});
CEL.qs("#div2").append(el1);
el2.append(el3);
el2.append(el4);
CEL.qs("#div2").append(el2);

var el1 = CEL.domCreate({elementType: "h3", style: {"background-color": "lightblue", "font-weight": "bold"}, innerHTML: "H3 Lorem ipsum from object with style string"});
var el2 = CEL.domCreate({elementType: "p", innerHTML: "Sample created paragraph"});
var el3 = CEL.domCreate("br");
var el4 = CEL.domCreate({elementType: "a", href: "https://developer.mozilla.org/en-US/", target: "_blank", style: "background-color: red; color: white;", innerHTML: "MDN Sample url"});
CEL.qs("#div2").append(el1);
el2.append(el3);
el2.append(el4);
CEL.qs("#div2").append(el2);

Test page

Please check the downloaded files in your download folder!

var txt = "✓ à \r\n\t árvíztűrő tükörfúrógép ÁRVÍZTŰRŐ TÜKÖRFÚRÓGÉP ,?;.:-_* ¤÷ר¸´˙`˛°˘^ˇ~'+!%/=()|\\\"\'\/#&@{}[]€ÍÄíŁß 0123456789 asdfghjklqwertzuiopyxcvbnm ASDFGHJKLQWERTZUIOPYXCVBNM";

no parameter
CEL.createFile();

only filename
CEL.createFile("test-createFile-error.txt");

default type
CEL.createFile("test-createFile.txt", txt);

"text/html" type
CEL.createFile("test-createFile.html", txt, "text/html");

Try

CEL.getLocation(
function (loc){
CEL.qs("#location").innerHTML = "latitude: "+loc.coords.latitude
+"br/longitude: "+loc.coords.longitude
+"br/"+"img src=\"https://maps.googleapis.com/maps/api/staticmap?center="
+loc.coords.latitude + "," + loc.coords.longitude
+"&zoom=14&size="+"400"+"x"+"400"+"&sensor=false\" alt=\"map\"";},
function (errorMessage) { CEL.qs("#location").innerHTML = errorMessage; }
);

domShow CEL.domShow( CEL.qs("#domhidetest") );

domShow display CEL.domShow( CEL.qs("#domhidetest"), "inline-block" );

domHide CEL.domHide( CEL.qs("#domhidetest") );

domToggle CEL.domToggle( CEL.qs("#domhidetest") );

domToggle display CEL.domToggle( CEL.qs("#domhidetest"), "inline-block" );

setCookie(); try CEL.setCookie("ctest3",cookieTestStr);

hasCookie(); try alert( CEL.hasCookie("ctest3") );

getCookie(name); try alert( CEL.getCookie("ctest3") );

getCookie(); try alert( JSON.stringify(CEL.getCookie()) );

removeCookie(); try alert( CEL.removeCookie("ctest3") );

Test Code:

var cookieTestStr = "✓ à \r\n\t árvíztűrő tükörfúrógép ÁRVÍZTŰRŐ TÜKÖRFÚRÓGÉP ,?;.:-_* ¤÷ר¸´˙`˛°˘^ˇ~'+!%/=()|\\ \" \/ # & @{}[]€ ÍÄíŁß 0123456789 asdhjklqweuioyxcbnm ASDHJKLQWEUIOYXCBNM \u00E0\u00E8\u00EC\u00F2\u00F9";
var cookiestr = "";

cookiestr += "\ndocument.cookie: \""+document.cookie+"\"";
CEL.setCookie("ctest1",cookieTestStr);
CEL.setCookie("ctest2",cookieTestStr);
cookiestr += "document.cookie: \""+document.cookie+"\"";
cookiestr += "\n"+(CEL.getCookie("ctest1"))+" - (cookie value)"; // cookie value
cookiestr += "\n"+(CEL.getCookie("ctest2"))+" - (cookie value)"; // cookie value
cookiestr += "\n"+(CEL.getCookie())+" - (object)"; // object
cookiestr += "\n"+(CEL.getCookie()["ctest1"])+" - (object value ctest1)"; // object value ctest1
cookiestr += "\n"+(CEL.getCookie()["ctest2"])+" - (object value ctest2)"; // object value ctest2
cookiestr += "\n"+(CEL.hasCookie("ctest1"))+" - (true)"; // true
cookiestr += "\n"+(CEL.hasCookie("ctest2"))+" - (true)"; // true
cookiestr += "\n"+(CEL.removeCookie("ctest1"))+" - (true)"; // true
cookiestr += "\n"+(CEL.hasCookie("ctest1"))+" - (false)"; // false
cookiestr += "\n"+(CEL.hasCookie("ctest2"))+" - (true)"; // true
cookiestr += "\ndocument.cookie: \""+document.cookie+"\"";
cookiestr += "\n"+(CEL.removeCookie("ctest1"))+" - (false)"; // false
cookiestr += "\n"+(CEL.removeCookie("ctest2"))+" - (true)"; // true
cookiestr += "\n"+(CEL.hasCookie("ctest1"))+" - (false)"; // false
cookiestr += "\n"+(CEL.hasCookie("ctest2"))+" - (false)"; // false
cookiestr += "\ndocument.cookie: \""+document.cookie+"\"";
cookiestr += "\n"+(CEL.removeCookie("ctest1"))+" - (false)"; // false
cookiestr += "\n"+(CEL.removeCookie("ctest2"))+" - (false)"; // false
cookiestr += "\n"+(CEL.hasCookie("ctest1"))+" - (false)"; // false
cookiestr += "\n"+(CEL.hasCookie("ctest2"))+" - (false)"; // false

CEL.qs("#cookieresults").innerHTML = cookiestr;

Test results:

cookieresults