npm - @codady/utils - Versions diffs - 0.0.38 → 0.0.39 - Mend

@codady/utils 0.0.38 → 0.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/CHANGELOG.md +18 -0
package/dist/utils.cjs.js +472 -23
package/dist/utils.cjs.min.js +2 -2
package/dist/utils.esm.js +472 -23
package/dist/utils.esm.min.js +2 -2
package/dist/utils.umd.js +472 -23
package/dist/utils.umd.min.js +2 -2
package/dist.zip +0 -0
package/examples/ajax-get.html +59 -0
package/examples/ajax-hook.html +55 -0
package/examples/ajax-method.html +36 -0
package/examples/ajax-post.html +37 -0
package/examples/buildUrl.html +99 -0
package/examples/getUrlHash.html +71 -0
package/modules.js +13 -1
package/modules.ts +13 -1
package/package.json +1 -1
package/src/ajax.js +363 -0
package/src/ajax.ts +450 -0
package/src/buildUrl.js +64 -0
package/src/buildUrl.ts +86 -0
package/src/capitalize - /345/211/257/346/234/254.js" +19 -0
package/src/capitalize.js +19 -0
package/src/capitalize.ts +20 -0
package/src/cleanQueryString.js +19 -0
package/src/cleanQueryString.ts +20 -0
package/src/getBodyHTML.js +53 -0
package/src/getBodyHTML.ts +61 -0
package/src/getEl.js +1 -1
package/src/getEl.ts +6 -5
package/src/getEls.js +1 -1
package/src/getEls.ts +5 -5
package/src/getUrlHash.js +37 -0
package/src/getUrlHash.ts +39 -0
package/src/isEmpty.js +24 -23
package/src/isEmpty.ts +26 -23
package/src/sliceStrEnd.js +63 -0
package/src/sliceStrEnd.ts +60 -0

package/src/cleanQueryString.ts ADDED Viewed

@@ -0,0 +1,20 @@
+/**
+ * @since Last modified: 2026/01/20 13:55:13
+ * Cleans a query string by removing the leading '?' or '&' character if it exists.
+ * This ensures that the string is in a valid format for use in URLSearchParams.
+ *
+ * @param {string} data - The query string to clean.
+ * @returns {string} The cleaned query string without leading '?' or '&'.
+ *
+ * @example
+ * cleanQueryString('?key=value&name=John'); // Returns 'key=value&name=John'
+ * cleanQueryString('&key=value&name=John'); // Returns 'key=value&name=John'
+ * cleanQueryString('key=value&name=John'); // Returns 'key=value&name=John'
+ */
+const cleanQueryString = (data: string): string => {
+    return typeof data === 'string' && (data.startsWith('?') || data.startsWith('&'))
+        ? data.slice(1)  // Remove the leading '?' or '&'
+        : data;  // Return the string as-is if no leading character is present
+};
+export default cleanQueryString;

package/src/getBodyHTML.js ADDED Viewed

@@ -0,0 +1,53 @@
+/**
+* @since Last modified: 2026/01/19 15:58:30
+ * Extract the inner content of the <body> tag from an HTML string.
+ * This method uses the browser's native DOMParser for reliable parsing,
+ * which is safer and more robust than using Regular Expressions.
+ * * @param {string} htmlText - The raw HTML string received from an asynchronous request.
+ * @param {string} [selector] - Optional ID or selector (e.g., '.hello' or '#hello').
+ * @returns {string} - The trimmed innerHTML of the body, or the original text if parsing fails.
+ */
+const getBodyHTML = (htmlText, selector) => {
+    // Return early if the input is not a valid string or doesn't look like HTML
+    if (!htmlText || typeof htmlText !== 'string') {
+        return '';
+    }
+    try {
+        /**
+         * 1. Initialize DOMParser
+         * DOMParser can parse XML or HTML source code from a string into a DOM Document.
+         */
+        const parser = new DOMParser(),
+        /**
+         * 2. Parse the string into a Document object
+         * The 'text/html' mime type tells the parser to use the HTML lifting/error-correction algorithms.
+         */
+        doc = parser.parseFromString(htmlText, 'text/html'),
+        /**
+         * 3. Extract body content
+         * Accessing doc.body automatically skips <!DOCTYPE>, <html>, and <head> sections.
+         * We use trim() to remove leading/trailing whitespace common in server responses.
+         */
+        bodyContent = doc.body.innerHTML;
+        if (selector) {
+            // Normalize hash: ensure it's a valid ID selector
+            const targetEl = doc.querySelector(selector);
+            if (targetEl) {
+                return targetEl.innerHTML;
+            }
+            // If hash is provided but element not found, we fallback to body or warn
+            console.warn(`Element with selector "${selector}" not found in the HTML.`);
+        }
+        return bodyContent ? bodyContent.trim() : htmlText;
+    }
+    catch (error) {
+        /**
+         * Fallback mechanism
+         * If the environment (like Node.js without JSDOM) doesn't support DOMParser,
+         * or the string is malformed, we log the error and return the raw text.
+         */
+        console.error("Failed to parse HTML content using DOMParser:", error);
+        return htmlText;
+    }
+};
+export default getBodyHTML;

package/src/getBodyHTML.ts ADDED Viewed

@@ -0,0 +1,61 @@
+/**
+* @since Last modified: 2026/01/19 15:58:30
+ * Extract the inner content of the <body> tag from an HTML string.
+ * This method uses the browser's native DOMParser for reliable parsing,
+ * which is safer and more robust than using Regular Expressions.
+ * * @param {string} htmlText - The raw HTML string received from an asynchronous request.
+ * @param {string} [selector] - Optional ID or selector (e.g., '.hello' or '#hello').
+ * @returns {string} - The trimmed innerHTML of the body, or the original text if parsing fails.
+ */
+const getBodyHTML = (htmlText: string, selector?: string): string => {
+  // Return early if the input is not a valid string or doesn't look like HTML
+  if (!htmlText || typeof htmlText !== 'string') {
+    return '';
+  }
+  try {
+    /**
+     * 1. Initialize DOMParser
+     * DOMParser can parse XML or HTML source code from a string into a DOM Document.
+     */
+    const parser: DOMParser = new DOMParser(),
+      /**
+       * 2. Parse the string into a Document object
+       * The 'text/html' mime type tells the parser to use the HTML lifting/error-correction algorithms.
+       */
+      doc: Document = parser.parseFromString(htmlText, 'text/html'),
+      /**
+       * 3. Extract body content
+       * Accessing doc.body automatically skips <!DOCTYPE>, <html>, and <head> sections.
+       * We use trim() to remove leading/trailing whitespace common in server responses.
+       */
+      bodyContent: string = doc.body.innerHTML;
+    if (selector) {
+      // Normalize hash: ensure it's a valid ID selector
+      const targetEl = doc.querySelector(selector);
+      if (targetEl) {
+        return targetEl.innerHTML;
+      }
+      // If hash is provided but element not found, we fallback to body or warn
+      console.warn(`Element with selector "${selector}" not found in the HTML.`);
+    }
+    return bodyContent ? bodyContent.trim() : htmlText;
+  } catch (error) {
+    /**
+     * Fallback mechanism
+     * If the environment (like Node.js without JSDOM) doesn't support DOMParser,
+     * or the string is malformed, we log the error and return the raw text.
+     */
+    console.error("Failed to parse HTML content using DOMParser:", error);
+    return htmlText;
+  }
+};
+export default getBodyHTML;

package/src/getEl.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2026/01/05 10:56:38
+ * @since Last modified: 2026/01/19 10:15:24
  * @function getEl
  * @description Get a DOM node (real or virtual). Supports obtaining nodes from various types (not just HTMLElement).
  * @param {string|Node} obj - Can be a node selector (e.g., #id, .classname, NODENAME, [attribute]) or any node type (HTMLElement, Node, DocumentFragment, etc.).

package/src/getEl.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2026/01/05 10:56:38
+ * @since Last modified: 2026/01/19 10:15:24
  * @function getEl
  * @description Get a DOM node (real or virtual). Supports obtaining nodes from various types (not just HTMLElement).
  * @param {string|Node} obj - Can be a node selector (e.g., #id, .classname, NODENAME, [attribute]) or any node type (HTMLElement, Node, DocumentFragment, etc.).
@@ -16,20 +16,21 @@
 'use strict';
 import getDataType from './getDataType';
+export type QueryableNode = Document | DocumentFragment | Element | SVGElement | HTMLElement | ShadowRoot;
-const getEl = (obj: string | Node | null, wrap: Node | string | null = document.body): Node | null => {
+const getEl = (obj: string | QueryableNode | null, wrap: string | QueryableNode | null = document.body): QueryableNode | null => {
     let objType = getDataType(obj),
         parType = getDataType(wrap),
         parent = parType.includes('HTML') ||  parType === 'ShadowRoot' ? wrap : document.querySelector(wrap as string),
         //如果parent是template节点，需要通过node.content.querySelector取得子节点
         root = parent && parent instanceof HTMLTemplateElement ? parent.content : parent,
-        result: Node | null = null;
+        result: QueryableNode | null = null;
     if (obj) {
         if (objType.includes('HTML')) {
-            result = (obj as Node);
+            result = (obj as QueryableNode);
         } else if (objType === 'String') {
             try {
-                result = (((root as Node) || document) as any).querySelector((obj as string).trim());
+                result = ((root as QueryableNode)  || document).querySelector((obj as string).trim());
                 //可能会报错，报错则返回null
             } catch {
                 result = null;

package/src/getEls.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2026/01/05 10:29:34
+ * @since Last modified: 2026/01/19 10:10:38
  * @function getEls
  * @description Get the node array.
  * @param {*} data  - It can be a single node selector or a node array.

package/src/getEls.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2026/01/05 10:29:34
+ * @since Last modified: 2026/01/19 10:10:38
  * @function getEls
  * @description Get the node array.
  * @param {*} data  - It can be a single node selector or a node array.
@@ -19,15 +19,15 @@
 //返回：一个节点数组。
 'use strict';
 import getDataType from './getDataType';
-import getEl from './getEl';
+import getEl, { QueryableNode } from './getEl';
 import isEmpty from './isEmpty';
-const getEls = (data: Node | string |  null | (Node | string)[], parent: Node | string | null = document.body): (Node | string)[] => {
+const getEls = (data: string | QueryableNode | null | (string | QueryableNode)[], parent: string | QueryableNode | null = document.body): QueryableNode[] => {
     let type = getDataType(data),
         parentEl = getEl(parent),
         root = parentEl && parentEl instanceof HTMLTemplateElement ? parentEl.content : (parentEl || document),
         result: any[] = [];
-        //data为空直接返回空数组
+    //data为空直接返回空数组
     if (isEmpty(data)) { return result; }
     if (type.includes('HTML')) {
         //一个节点
@@ -39,7 +39,7 @@ const getEls = (data: Node | string |  null | (Node | string)[], parent: Node |
             return [...(root as any).querySelectorAll(k)];
         }).flat();
     } else if (type === 'Array') {
-        result = (data as (Node | string)[]).map((k: any) => {
+        result = (data as QueryableNode[]).map((k: any) => {
             return getEl(k, parentEl);
         });
     }

package/src/getUrlHash.js ADDED Viewed

@@ -0,0 +1,37 @@
+/**
+* @since Last modified: 2026/01/19 09:56:44
+ * Extracts the hash (fragment) portion of a given URL or file path.
+ * * This function utilizes the native `URL` constructor to parse the input.
+ * It is a pure logical operation and does not trigger any network requests.
+ * * @param {string} url - The URL string or file path to parse (e.g., 'index.html#section', 'https://example.com#top').
+ * @returns {string} - The hash part of the URL including the '#' character (e.g., '#section').
+ * Returns an empty string if no hash is present or if the input is invalid.
+ * * @example
+ * getUrlHash('https://example.com/page#header'); // Returns '#header'
+ * getUrlHash('src/assets/style.css#debug');      // Returns '#debug'
+ */
+const getUrlHash = (url) => {
+    // Return empty if input is null, undefined, or not a string
+    if (!url || typeof url !== 'string') {
+        return '';
+    }
+    try {
+        /**
+         * Use window.location.origin as the base URL to support relative paths.
+         * The URL constructor follows the WHATWG spec:
+         * 1. If 'url' is absolute (e.g., starts with http://), the base is ignored.
+         * 2. If 'url' is relative (e.g., starts with ../), it is resolved against the base.
+         * In both cases, the .hash property correctly extracts the fragment.
+         */
+        const baseUrl = window?.location?.origin || 'https://www.axui.cn', urlObj = new URL(url, baseUrl);
+        return urlObj.hash;
+    }
+    catch (error) {
+        /**
+         * Catch parsing errors for malformed strings.
+         * Since this is a utility, we fail silently and return an empty string.
+         */
+        return '';
+    }
+};
+export default getUrlHash;

package/src/getUrlHash.ts ADDED Viewed

@@ -0,0 +1,39 @@
+/**
+* @since Last modified: 2026/01/19 09:56:44
+ * Extracts the hash (fragment) portion of a given URL or file path.
+ * * This function utilizes the native `URL` constructor to parse the input.
+ * It is a pure logical operation and does not trigger any network requests.
+ * * @param {string} url - The URL string or file path to parse (e.g., 'index.html#section', 'https://example.com#top').
+ * @returns {string} - The hash part of the URL including the '#' character (e.g., '#section').
+ * Returns an empty string if no hash is present or if the input is invalid.
+ * * @example
+ * getUrlHash('https://example.com/page#header'); // Returns '#header'
+ * getUrlHash('src/assets/style.css#debug');      // Returns '#debug'
+ */
+const getUrlHash = (url: string): string => {
+  // Return empty if input is null, undefined, or not a string
+  if (!url || typeof url !== 'string') {
+    return '';
+  }
+  try {
+    /**
+     * Use window.location.origin as the base URL to support relative paths.
+     * The URL constructor follows the WHATWG spec:
+     * 1. If 'url' is absolute (e.g., starts with http://), the base is ignored.
+     * 2. If 'url' is relative (e.g., starts with ../), it is resolved against the base.
+     * In both cases, the .hash property correctly extracts the fragment.
+     */
+    const baseUrl: string = window?.location?.origin || 'https://www.axui.cn',
+      urlObj: URL = new URL(url, baseUrl);
+    return urlObj.hash;
+  } catch (error) {
+    /**
+     * Catch parsing errors for malformed strings.
+     * Since this is a utility, we fail silently and return an empty string.
+     */
+    return '';
+  }
+};
+export default getUrlHash;

package/src/isEmpty.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2025/12/25 14:22:26
+ * @since Last modified: 2026/01/20 12:02:43
  * @function isEmpty
  * @description Determine whether it is empty data.The data itself is empty data: 0| ''|false|undefined|null; <br>empty function: function () {}|() => {}; <br>empty array and empty objects: []|{}| [null]| [ undefined]| ['']| [""];<br> empty symbol object: symbol()|symbol.For(), will be judged as empty.
  * @param {*} data  - Can be any data
@@ -16,30 +16,31 @@ const isEmpty = (data) => {
     let type = getDataType(data), flag;
     if (!data) {
         //0,'',false,undefined,null
-        flag = true;
+        return true;
     }
-    else {
-        //function(){}|()=>{}
-        //[null]|[undefined]|['']|[""]
-        //[]|{}
-        //Symbol()|Symbol.for()
-        //Set,Map
-        //Date/Regex
-        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
-            (type === 'Array') ? data.join('') === '' :
-                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
-                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
-                        (type === 'Set' || type === 'Map') ? data.size === 0 :
-                            type === 'Date' ? isNaN(data.getTime()) :
-                                type === 'RegExp' ? data.source === '' :
-                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
-                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
-                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
-                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
-                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
-                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
-                                                            false;
+    if (['String', 'Number', 'Boolean'].includes(type)) {
+        return false;
     }
+    //function(){}|()=>{}
+    //[null]|[undefined]|['']|[""]
+    //[]|{}
+    //Symbol()|Symbol.for()
+    //Set,Map
+    //Date/Regex
+    flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+        (type === 'Array') ? data.join('') === '' :
+            (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                    (type === 'Set' || type === 'Map') ? data.size === 0 :
+                        type === 'Date' ? isNaN(data.getTime()) :
+                            type === 'RegExp' ? data.source === '' :
+                                type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                    (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                        ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                            ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                    (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                        false;
     return flag;
 };
 export default isEmpty;

package/src/isEmpty.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2025/12/25 14:22:26
+ * @since Last modified: 2026/01/20 12:02:43
  * @function isEmpty
  * @description Determine whether it is empty data.The data itself is empty data: 0| ''|false|undefined|null; <br>empty function: function () {}|() => {}; <br>empty array and empty objects: []|{}| [null]| [ undefined]| ['']| [""];<br> empty symbol object: symbol()|symbol.For(), will be judged as empty.
  * @param {*} data  - Can be any data
@@ -16,29 +16,32 @@ const isEmpty = (data: any): boolean => {
     let type = getDataType(data), flag: boolean;
     if (!data) {
         //0,'',false,undefined,null
-        flag = true;
-    } else {
-        //function(){}|()=>{}
-        //[null]|[undefined]|['']|[""]
-        //[]|{}
-        //Symbol()|Symbol.for()
-        //Set,Map
-        //Date/Regex
-        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
-            (type === 'Array') ? data.join('') === '' :
-                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
-                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
-                        (type === 'Set' || type === 'Map') ? data.size === 0 :
-                            type === 'Date' ? isNaN(data.getTime()) :
-                                type === 'RegExp' ? data.source === '' :
-                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
-                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
-                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
-                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
-                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
-                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
-                                                            false;
+        return true;
     }
+    if (['String', 'Number', 'Boolean'].includes(type)) {
+        return false;
+    }
+    //function(){}|()=>{}
+    //[null]|[undefined]|['']|[""]
+    //[]|{}
+    //Symbol()|Symbol.for()
+    //Set,Map
+    //Date/Regex
+    flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+        (type === 'Array') ? data.join('') === '' :
+            (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                    (type === 'Set' || type === 'Map') ? data.size === 0 :
+                        type === 'Date' ? isNaN(data.getTime()) :
+                            type === 'RegExp' ? data.source === '' :
+                                type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                    (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                        ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                            ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                    (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                        false;
     return flag;
 }
 export default isEmpty;

package/src/sliceStrEnd.js ADDED Viewed

@@ -0,0 +1,63 @@
+/**
+ * @since Last modified: 2023-12-08 11:37:11
+ * @function sliceStrEnd
+ * @description Use keyword to cut forward or backwards from the string.
+ * @param {object} options  - The parameter object of the function.
+ * @property {string} options.str  - The string to be intercepted.Allow keyword many times.
+ * @property {string} [options.key='#']  - Keywords participating in intercepting.
+ * @property {string} [options.type='beforebegin'|'afterbegin'|'beforeend'|'afterend']  - Method of intercepting.The optional values include 'beforebegin','afterbegin','beforeend' and 'afterend'
+ * @property {boolean} [options.contain=true]  - Whether the output result contains keyword.
+ * @returns {string|''} - Return the interception string does not change the original string.
+ * @see {@link https://codepen.io/axui/pen/NWoOKEY|demo @ codepen}
+ * @example
+ * ax.sliceStrEnd({str:'123#321',key:'#'});
+ * <!--return interception string -->
+ */
+//简介：使用关键字从字符串中向前或向后截取字符串。
+//参数options：截取参数，是一个对象。
+//参数属性str：将要被截取的字符串。允许key出现多次。
+//参数属性key：截取的关键字。
+//参数属性type：截取类型，可选值包括：'beforebegin'，'afterbegin'，'beforeend'，'afterend'。
+//参数属性contain：输出结果是否包含key，默认true。
+//返回：截取后的字符串，不改变原字符串。
+'use strict';
+const sliceStrEnd = ({ str = '', key = '#', type = 'afterend', contain = true }) => {
+    //str和key先强制转字符串
+    str = str.toString();
+    key = key.toString();
+    let result = '', indexKey = 0, lenKey = key.length, lenEnd = str.length, indexStart = 0;
+    //str和key不能为空，否则直接输出空值。允许填入0
+    if (!str || !key) {
+        return result;
+    }
+    str = str.trim();
+    if (str.includes(key)) {
+        if (type === 'beforebegin') {
+            indexKey = str.indexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        }
+        else if (type === 'afterbegin') {
+            indexKey = str.indexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        }
+        else if (type === 'beforeend') {
+            indexKey = str.lastIndexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        }
+        else if (type === 'afterend') {
+            indexKey = str.lastIndexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        }
+        result = str.substring(indexStart, lenEnd);
+    }
+    return result;
+};
+export default sliceStrEnd;

package/src/sliceStrEnd.ts ADDED Viewed

@@ -0,0 +1,60 @@
+/**
+ * @since Last modified: 2023-12-08 11:37:11
+ * @function sliceStrEnd
+ * @description Use keyword to cut forward or backwards from the string.
+ * @param {object} options  - The parameter object of the function.
+ * @property {string} options.str  - The string to be intercepted.Allow keyword many times.
+ * @property {string} [options.key='#']  - Keywords participating in intercepting.
+ * @property {string} [options.type='beforebegin'|'afterbegin'|'beforeend'|'afterend']  - Method of intercepting.The optional values include 'beforebegin','afterbegin','beforeend' and 'afterend'
+ * @property {boolean} [options.contain=true]  - Whether the output result contains keyword.
+ * @returns {string|''} - Return the interception string does not change the original string.
+ * @see {@link https://codepen.io/axui/pen/NWoOKEY|demo @ codepen}
+ * @example
+ * ax.sliceStrEnd({str:'123#321',key:'#'});
+ * <!--return interception string -->
+ */
+//简介：使用关键字从字符串中向前或向后截取字符串。
+//参数options：截取参数，是一个对象。
+//参数属性str：将要被截取的字符串。允许key出现多次。
+//参数属性key：截取的关键字。
+//参数属性type：截取类型，可选值包括：'beforebegin'，'afterbegin'，'beforeend'，'afterend'。
+//参数属性contain：输出结果是否包含key，默认true。
+//返回：截取后的字符串，不改变原字符串。
+'use strict';
+const sliceStrEnd = ({ str = '', key = '#', type = 'afterend', contain = true }: { str: string, key?: string, type?: 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend', contain?: boolean }): string => {
+    //str和key先强制转字符串
+    str = str.toString();
+    key = key.toString();
+    let result = '', indexKey = 0, lenKey = key.length, lenEnd = str.length, indexStart = 0;
+    //str和key不能为空，否则直接输出空值。允许填入0
+    if (!str || !key) {
+        return result;
+    }
+    str = str.trim();
+    if (str.includes(key)) {
+        if (type === 'beforebegin') {
+            indexKey = str.indexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        } else if (type === 'afterbegin') {
+            indexKey = str.indexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        } else if (type === 'beforeend') {
+            indexKey = str.lastIndexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        } else if (type === 'afterend') {
+            indexKey = str.lastIndexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        }
+        result = str.substring(indexStart, lenEnd);
+    }
+    return result;
+}
+export default sliceStrEnd;