als-document 1.0.1-alpha → 1.0.2-alpha

package/index.mjs

@@ -1,6 +1,6 @@
 class Query{
   static get(query){
      let q=new Query(query)
      return q.selectors
   }
    constructor(query){
      this.query=query
      this.selectors=[]
      this.stringValues=[];
      this.parseSelectors(query.split(','))
   }
    parseSelectors(selectors){
      selectors.forEach(selector=>{
         let originalSelector=selector.trim()
         selector=this.removeSpaces(selector)
         this.stringValues=[]
         selector=selector.replace(/\[.*?\]/g,(value)=>{
            this.stringValues.push(value)
            return `[${this.stringValues.length-1}]`
         })
         let [element,ancestors]=this.splitAndCutLast(selector,' ')
         element=this.getFamily(element)
         if (ancestors.length>0)
            element.ancestors=ancestors.map(ancestor=>this.getFamily(ancestor))
         element.group=originalSelector
         this.selectors.push(element)
      });
   }
    splitAndCutLast(string,splitBy){
      const array=string.split(splitBy);
      const last=array.pop();
      return [last,array];
   }
    getFamily(group,element,prev,prevAny,sign){
      if (group.match(/\~|\+/)!==null){
         let [last,prevBrothers]=this.splitAndCutLast(group,/\~|\+/)
         let signs=group.replace(last,'')
         prevBrothers.forEach(el=>signs=signs.replace(el,''))
         signs=signs.match(/\~|\+/g)
         if (signs.length==1){
            sign=signs[0]
         } else if (signs.length>1){
            sign=signs.splice(signs.length-1,signs.length-1)[0]
            prevBrothers[0]=prevBrothers.map((b,i)=>{
               if (i< prevBrothers.length-1) b+=signs[i]
               return b
            }).join('')
            prevBrothers[0]=this.getFamily(prevBrothers[0])
         }
         if (sign=='~') prevAny=prevBrothers[0]
         else if (sign=='+') prev=prevBrothers[0]
         element=last
      } else element=group
      let family
      if (prev || prevAny){
         family=this.getParents(element)
         if (prev) family.prev=this.getParents(prev)
         if (prevAny) family.prevAny=this.getParents(prevAny)
      } else family=this.getParents(element)
      if (family.query!==group) family.group=group
      return family
   }
    getParents(selector){
      if (typeof selector=='string'){
         let [element,parents]=this.splitAndCutLast(selector,'>')
         element=this.buildElement(element)
         parents=parents.map(parent=>this.buildElement(parent))
         if (parents.length>0) element.parents=parents
         return element
      } else return selector
   }
    buildElement(element,id=null,tag=null,classList=[]){
      let query=element
      element=element.replace(/\#(\w-?)*/,$id=>{
         id=$id.replace(/^\#/,''); return ''
      })
      element=element.replace(/\.(\w-?)*/,$class=>{
         classList.push($class.replace(/^\./,'')); return ''
      })
      element=element.replace(/(\w\:?-?)*/,$tag=>{
         tag=$tag=='' ? null : $tag; return ''
      })
      let attribs=this.getAttributes(element)
      element={ query }
      if (id) element.id=id
      if (tag) element.tag=tag
      if (classList.length>0) element.classList=classList
      if (attribs.length>0) element.attribs=attribs
      return element
   }
    getAttributes(element){
      let attribs=this.stringValues.filter((value,index)=>{
         let searchValue=`[${index}]`
         if (element.match(searchValue)) return true
         else return false
      })
      attribs=attribs.map(attrib=>{
         let query=attrib
         attrib=attrib.replace('[','').replace(']','')
         let [name,value]=attrib.split(/[\~\|\^\$\*]?\=/)
         let sign=attrib.replace(name,'').replace(value,'')
         attrib={ query }
         if (name) attrib.name=name
         if (value) attrib.value=value.trim().replace(/^\"/,'').replace(/\"$/,'')
         if (sign){
            attrib.sign=sign
            attrib.check=this.getAttribFn(sign).bind(attrib)
         }
         return attrib
      });
      return attribs
   }
    getAttribFn(sign){
      if (sign=='=') return function (value){ return value===this.value }
      if (sign=='*=') return function (value){ return value.includes(this.value) }
      if (sign=='^=') return function (value){ return value.startsWith(this.value) }
      if (sign=='$=') return function (value){ return value.endsWith(this.value) }
      if (sign=='|=') return function (value){
         return value.trim().split(' ').length==1
            && (value.startsWith(this.value) || value.startsWith(this.value+'-'))
            ? true : false
      }
      if (sign=='~=') return function (value){
         return this.value.trim().split(' ').length==1 && value.includes(this.value) ? true : false
      }
   }
    removeSpaces(selector){
      selector=selector.replace(/\s{2}/g,' ')
      selector=selector.replace(/\s?\^?\$?\|?\~?\*?\=\s*/g,(m)=>m.trim())
      selector=selector.replace(/\s?(\+|\~|\>)\s?/g,(m)=>m.trim())
      return selector
   }
 }
-function checkElement(el,selector){
   if(selector==undefined) return true
   if(el==null) return false
   let{tag,classList,attributes,id,prev,ancestors,parents,prevAny}=selector
   if(typeof el==='string') return false
   if(el.isSpecial) return false
   if(id!==undefined && el.id===null) return false
   if(id && id!==el.id) return false
   if(tag && el.tagName===undefined) return false
   else if(tag && tag!==el.tagName) return false
   const clas=el.attributes.class
   if(classList!==undefined && (clas===undefined || clas==='')) return false
   else if(classList!==undefined){
      if(classList.every(e=>el.classList.contains(e))===false) return false
   }
   if(checkattributes(attributes,el)===false) return false
   if(checkElement(el.prev,prev)===false) return false
   if(checkAncestors(el.ancestors,ancestors)===false) return false
   if(checkParents(el.ancestors,parents)===false) return false
   if(el.parent){
      if(checkPrevAny(el.parent.children,el.childIndex,prevAny)==false) return false
   }
   return true
+function checkElement(el,selector){
   if(selector==undefined) return true
   if(el==null) return false
   let{tag,classList,attributes,id,prev,ancestors,parents,prevAny}=selector
   if(typeof el==='string') return false
   if(id!==undefined && el.id===null) return false
   if(id && id!==el.id) return false
   if(tag && el.tagName===undefined) return false
   else if(tag && tag!==el.tagName) return false
   const clas=el.attributes.class
   if(classList!==undefined && (clas===undefined || clas==='')) return false
   else if(classList!==undefined){
      if(classList.every(e=>el.classList.contains(e))===false) return false
   }
   if(checkattributes(attributes,el)===false) return false
   if(checkElement(el.prev,prev)===false) return false
   if(checkAncestors(el.ancestors,ancestors)===false) return false
   if(checkParents(el.ancestors,parents)===false) return false
   if(el.parent){
      if(checkPrevAny(el.parent.children,el.childIndex,prevAny)==false) return false
   }
   return true
 }
  function checkattributes(attributes=[],el){
   let elattributes=el.attributes
   let names=Object.keys(elattributes)
   let passedTests=0
   if(attributes) for(let i=0; i<attributes.length; i++){
      let{name,value,check}=attributes[i]
      if(name=='inner' && value!==undefined && check && el.inner){
         if(check(el.inner)) passedTests++
      }
       if(!names.includes(name)) continue
      else if(value==undefined) passedTests++
      else if(value && elattributes[name]){
         if(check(elattributes[name])==false) continue
         else passedTests++
      }
   }
   if(passedTests==attributes.length) return true
   else return false
 }
  function checkPrevAny(children=[],index,prevAny){
   let size=children.length
   if((size==0 || index==0) && prevAny) return false
   for(let i=index; i>=0; i--){
      if(checkElement(children[i],prevAny)) return true
   }
   return false
 }
  function checkAncestors(ancestors=[],selectorAncestors=[]){
   let count=0
   if(selectorAncestors.length==0) return true
   let endIndex=ancestors.length-1
   let selectorIndex=selectorAncestors.length-1
   while(selectorIndex>=0){
      for(let i=endIndex; i>=0; i--){
         endIndex=i-1
         if(checkElement(ancestors[i],selectorAncestors[selectorIndex])==true){
            count++
            break
         }
      }
      selectorIndex--
   }
   if(count==selectorAncestors.length) return true
   else return false
@@ -20,9 +20,9 @@ function buildStyle(attributes){
   const styles=attributes.style || "";
    con
 
 class NodeClassList{
   constructor(node){ this.node=node }
   get classes(){ return (this.node.attributes.class || "").split(" ").filter(Boolean) }
   set classes(val){ this.node.attributes.class=val.join(" ") }
   contains(className){ return this.classes.includes(className) }
    add(className){
      const currentClasses=this.classes;
      if (!currentClasses.includes(className)) this.classes=[...currentClasses,className];
   }
    remove(className){ this.classes=this.classes.filter(cls=>cls!==className); }
    toggle(className){
      if (this.classes.includes(className)) this.remove(className);
      else this.add(className);
   }
    replace(oldClass,newClass){
      if (this.classes.includes(oldClass)){
         this.remove(oldClass);
         this.add(newClass);
      }
   }
 }
-class Node{
   constructor(tagName,attributes={},parent=null){
      this.isSingle=false;
      this.tagName=tagName;
      this.attributes=attributes;
      this.childNodes=[];
      if (parent!==null) parent.childNodes.push(this)
      this.parent=parent;
      this._classList=null;
      this.__style=null;
      this._dataset=null
   }
    get id(){ return this.attributes.id || null; }
   get className(){return this.attributes.class || null}
   get parentNode(){ return this.parent }
   get ancestors(){
      const ancestors=[]
      let element=this.parent
      while (element.tagName!=='ROOT'){
         ancestors.push(element)
         element=element.parent
      }
      return ancestors.reverse()
   }
    get childIndex(){ return this.parent.childNodes ? this.parent.childNodes.indexOf(this) : null }
   get previousElementSibling(){ return this.prev }
   get prev(){
      if (!this.childIndex) return null
      return this.parent.childNodes[this.childIndex-1]
   }
    get nextElementSibling(){ return this.next }
   get next(){
      if (!this.childIndex) return null
      return this.parent.childNodes[this.childIndex+1] || null
   }
    get dataset(){
      if (!this._dataset) this._dataset=getDataset(this);
      return this._dataset;
   }
    get classList(){
      if (!this._classList) this._classList=new NodeClassList(this);
      return this._classList;
   }
    get style(){
      if (!this.__style) this.__style=buildStyle(this.attributes)
      return this.__style
   }
    get outerHTML(){
      const attrs=Object.entries(this.attributes).map(([key,val])=>`${key}="${val}"`).join(" ");
      return `<${this.tagName} ${attrs}>${this.innerHTML}</${this.tagName}>`;
   }
    getAttribute(attrName){ return this.attributes[attrName] || null }
   setAttribute(attrName,value){ this.attributes[attrName]=value }
   removeAttribute(attrName){ delete this.attributes[attrName] }
    remove(){
      if (!this.parent) return
      const index=this.childIndex;
      if (index!==null) this.parent.childNodes.splice(index,1);
   }
    get innerHTML(){
      return this.childNodes.map(child=>{
         if (child instanceof Node || child instanceof SingleNode) return child.outerHTML;
         else if (child instanceof TextNode) return child.textContent;
         else return child
      }).join("");
   }
    $$(query){return this.querySelectorAll(query)}
   querySelectorAll(query){
      const selectors=Query.get(query)
      return find(selectors,this,new Set())
   }
   $(query){return this.querySelector(query)}
   querySelector(query){
      const selectors=Query.get(query)
      return find(selectors,this,new Set(),true)[0]
   }
    getElementsByClassName(query){ return this.querySelectorAll('.'+query) }
   getElementsByTagName(query){ return this.querySelectorAll(query) }
   getElementById(query){ return this.querySelector('#'+query) }
    get children(){
      return this.childNodes.filter(child=>{
         if (!(child instanceof Node)) return false
         if (child.tagName==='#comment') return false
         return true
      });
   }
    insertAdjacentElement(position,newElement){
      if(newElement.tagName==='ROOT' && newElement.childNodes.length>0) newElement=newElement.childNodes[0]
      const pos=position.toLowerCase();
      if (pos==="afterbegin") this.childNodes.unshift(newElement);
      else if (pos==="beforeend") this.childNodes.push(newElement);
      if (!this.parent) return newElement
      if (pos==="beforebegin") this.parent.childNodes.unshift(newElement);
      else if (pos==="afterend") this.parent.childNodes.splice(this.childIndex+1,0,newElement);
      return newElement
   }
    insertAdjacentHTML(position,html){
      const newNode=parseHTML(html);
      return this.insertAdjacentElement(position,newNode);
   }
    insertAdjacentText(position,text){
      return this.insertAdjacentElement(position,new TextNode(text));
   }
    set innerHTML(html){
      const parsed=parseHTML(html);
      this.childNodes=parsed.childNodes;
   }
    set outerHTML(html){
      const parsed=parseHTML(html);
      if (!this.parent) return console.log('element has no parent node')
      const index=this.childIndex
      if (index!==null) this.parent.childNodes.splice(index,1,...parsed.childNodes);
   }
    appendChild(newChild){
      if (newChild instanceof Node || newChild instanceof TextNode || newChild instanceof SingleNode){
         if (newChild.parent) newChild.parent.childNodes=newChild.parent.childNodes.filter(child=>child!==newChild);
      } else if(typeof newChild==='string') newChild=new TextNode(newChild)
      else return newChild
      this.childNodes.push(newChild);
      newChild.parent=this;
      return newChild;
   }
    get textContent(){
      if (this.childNodes.length===0) return this.nodeName==='#text' ? this.nodeValue : '';
      return this.childNodes.map(child=>{
         if(child instanceof SingleNode) return ''
         if(child instanceof TextNode) return child.nodeValue
         if(child instanceof Node) return child.textContent;
         else return child;
      }).join(" ");
   }
    set textContent(value){
      this.childNodes=[];
      if (value!==null && value!==undefined){
         this.childNodes.push(value.toString());
      }
   }
+class Node{
   constructor(tagName,attributes={},parent=null){
      this.isSingle=false;
      this.tagName=tagName;
      this.attributes=attributes;
      this.childNodes=[];
      if (parent!==null) parent.childNodes.push(this)
      this.parent=parent;
      this._classList=null;
      this.__style=null;
      this._dataset=null
   }
    get id(){ return this.attributes.id || null; }
   get className(){return this.attributes.class || null}
   get parentNode(){ return this.parent }
   get ancestors(){
      const ancestors=[]
      let element=this.parent
      while (element.tagName!=='ROOT'){
         ancestors.push(element)
         element=element.parent
      }
      return ancestors.reverse()
   }
    get childIndex(){ return this.parent.childNodes ? this.parent.childNodes.indexOf(this) : null }
   get previousElementSibling(){ return this.prev }
   get prev(){
      if (!this.childIndex) return null
      return this.parent.childNodes[this.childIndex-1]
   }
    get nextElementSibling(){ return this.next }
   get next(){
      if (!this.childIndex) return null
      return this.parent.childNodes[this.childIndex+1] || null
   }
    get dataset(){
      if (!this._dataset) this._dataset=getDataset(this);
      return this._dataset;
   }
    get classList(){
      if (!this._classList) this._classList=new NodeClassList(this);
      return this._classList;
   }
    get style(){
      if (!this.__style) this.__style=buildStyle(this.attributes)
      return this.__style
   }
    get outerHTML(){
      const attrs=Object.entries(this.attributes).map(([key,val])=>`${key}="${val}"`).join(" ");
      return `<${this.tagName} ${attrs}>${this.innerHTML}</${this.tagName}>`;
   }
    getAttribute(attrName){ return this.attributes[attrName] || null }
   setAttribute(attrName,value){ this.attributes[attrName]=value }
   removeAttribute(attrName){ delete this.attributes[attrName] }
    remove(){
      if (!this.parent) return
      const index=this.childIndex;
      if (index!==null) this.parent.childNodes.splice(index,1);
   }
    get innerHTML(){
      return this.childNodes.map(child=>{
         if (child instanceof Node || child instanceof SingleNode) return child.outerHTML;
         else if (child instanceof TextNode) return child.textContent;
         else return child
      }).join("");
   }
    $$(query){return this.querySelectorAll(query)}
   querySelectorAll(query){
      const selectors=Query.get(query)
      return find(selectors,this,new Set())
   }
   $(query){return this.querySelector(query)}
   querySelector(query){
      const selectors=Query.get(query)
      return find(selectors,this,new Set(),true)[0] || null
   }
    getElementsByClassName(query){ return this.querySelectorAll('.'+query) }
   getElementsByTagName(query){ return this.querySelectorAll(query) }
   getElementById(query){ return this.querySelector('#'+query) }
    get children(){
      return this.childNodes.filter(child=>{
         if (!(child instanceof Node)) return false
         if (child.tagName==='#comment') return false
         return true
      });
   }
    insertAdjacentElement(position,newElement){
      if(newElement.tagName==='ROOT' && newElement.childNodes.length>0) newElement=newElement.childNodes[0]
      const pos=position.toLowerCase();
      if (pos==="afterbegin") this.childNodes.unshift(newElement);
      else if (pos==="beforeend") this.childNodes.push(newElement);
      if (!this.parent) return newElement
      if (pos==="beforebegin") this.parent.childNodes.unshift(newElement);
      else if (pos==="afterend") this.parent.childNodes.splice(this.childIndex+1,0,newElement);
      return newElement
   }
    insertAdjacentHTML(position,html){
      const newNode=parseHTML(html);
      return this.insertAdjacentElement(position,newNode);
   }
    insertAdjacentText(position,text){
      return this.insertAdjacentElement(position,new TextNode(text));
   }
    set innerHTML(html){
      const parsed=parseHTML(html);
      this.childNodes=parsed.childNodes;
   }
    set outerHTML(html){
      const parsed=parseHTML(html);
      if (!this.parent) return console.log('element has no parent node')
      const index=this.childIndex
      if (index!==null) this.parent.childNodes.splice(index,1,...parsed.childNodes);
   }
    appendChild(newChild){
      if (newChild instanceof Node || newChild instanceof TextNode || newChild instanceof SingleNode){
         if (newChild.parent) newChild.parent.childNodes=newChild.parent.childNodes.filter(child=>child!==newChild);
      } else if(typeof newChild==='string') newChild=new TextNode(newChild)
      else return newChild
      this.childNodes.push(newChild);
      newChild.parent=this;
      return newChild;
   }
    get textContent(){
      if (this.childNodes.length===0) return this.nodeName==='#text' ? this.nodeValue : '';
      return this.childNodes.map(child=>{
         if(child instanceof SingleNode) return ''
         if(child instanceof TextNode) return child.nodeValue
         if(child instanceof Node) return child.textContent;
         else return child;
      }).join(" ");
   }
    set textContent(value){
      this.childNodes=[];
      if (value!==null && value!==undefined){
         this.childNodes.push(value.toString());
      }
   }
 }
-class SingleNode extends Node{
   constructor(tagName,attributes={},parent=null){
      if(attributes['?'] && tagName==='?xml') delete attributes['?']
      super(tagName,attributes,parent);
      this.isSingle=true
   }
    get outerHTML(){
      if (this.tagName==="#cdata-section") return `<![CDATA[${this.textContent}]]>`;
      const attrs=Object.entries(this.attributes).map(([key,val])=>`${key}="${val}"`).join(" ");
      return `<${this.tagName} ${attrs}${this.tagName==='?xml' ? '?' : ''}>`;
   }
    get innerHTML(){ return ""; }
   set innerHTML(_){ }
   $(_){return null}
   $$(_){return []}
   querySelectorAll(_){ return []; }
   querySelector(_){ return null; }
   getElementsByClassName(_){ return []; }
   getElementsByTagName(_){ return []; }
   getElementById(_){ return null; }
   get children(){ return []; }
   insertAdjacentElement(_,__){ }
   insertAdjacentHTML(_,__){ }
   insertAdjacentText(_,__){ }
   appendChild(_){ }
   get textContent(){ return ""; }
   set textContent(_){ }
+class SingleNode extends Node{
   constructor(tagName,attributes={},parent=null){
      if(attributes['?'] && tagName==='?xml') delete attributes['?']
      super(tagName,attributes,parent);
      this.isSingle=true
   }
    get outerHTML(){
      if (this.tagName==="#cdata-section") return `<![CDATA[${this.nodeValue}]]>`;
      const attrs=Object.entries(this.attributes).map(([key,val])=>`${key}="${val}"`).join(" ");
      return `<${this.tagName} ${attrs}${this.tagName==='?xml' ? '?' : ''}>`;
   }
    get innerHTML(){ return ""; }
   set innerHTML(_){ }
   $(_){return null}
   $$(_){return []}
   querySelectorAll(_){ return []; }
   querySelector(_){ return null; }
   getElementsByClassName(_){ return []; }
   getElementsByTagName(_){ return []; }
   getElementById(_){ return null; }
   get children(){ return []; }
   insertAdjacentElement(_,__){ }
   insertAdjacentHTML(_,__){ }
   insertAdjacentText(_,__){ }
   appendChild(_){ }
   get textContent(){ return ""; }
   set textContent(_){ }
 }
 function parseAttributes(str){
   const attrs={};
   let key="";
   let value="";
   let isKey=true;
   let quoteChar=null;
    for (let i=0; i< str.length; i++){
      const char=str[i];
       if (isKey && (char==='=' || char===' ')){
         if (char==='=') isKey=false;
         else if (key.trim()){
            attrs[key.trim()]=true;
            key="";
         }
         continue;
      }
       if (!quoteChar && (char==='"' || char==="'")){
         quoteChar=char;
         continue;
      } else if (quoteChar && char===quoteChar){
         quoteChar=null;
         attrs[key.trim()]=value.trim();
         key=""; value=""; isKey=true;
         continue;
      }
       if (isKey) key+=char;
      else value+=char;
   }
    if (key.trim() &&!value) attrs[key.trim()]=true;
   return attrs;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "als-document",
-  "version": "1.0.1-alpha",
+  "version": "1.0.2-alpha",
   "description": "A powerful HTML parser & DOM manipulation library for both backend and frontend.",
   "main": "index.js",
   "module": "index.mjs",

package/src/build.js

@@ -2,8 +2,7 @@ const { readFileSync, writeFileSync, watchFile, watch } = require('fs')
 const { join,basename } = require('path')
 
 function optimizeCode(content) {
-   content = content.replace(/(?<!\\)\/\/.*$/gm, '') // remove comments
-   // content = content.replace(/\;\s*?$/gm,'') // remove ; at end of line
+   content = content.replace(/^(?<!\\)\/\/.*$|(?<=\s)(?<!\\)\/\/.*$/gm, '') // remove comments
    content = content.replace(/\[\s*?\n\s*/gm, '[') // 
    content = content.replace(/\s*?\]/gm, ']') // 
    content = content.replace(/\s*?$/gm, '') // remove space at end of line

package/src/node/node.js

@@ -83,7 +83,7 @@ class Node {
    $(query) {return this.querySelector(query)}
    querySelector(query) {
       const selectors = Query.get(query)
-      return find(selectors, this, new Set(), true)[0]
+      return find(selectors, this, new Set(), true)[0] || null
    }
 
    getElementsByClassName(query) { return this.querySelectorAll('.' + query) }

package/src/node/single-node.js

@@ -6,7 +6,7 @@ class SingleNode extends Node {
    }
    
    get outerHTML() { // Переопределение outerHTML для одиночного узла
-      if (this.tagName === "#cdata-section") return `<![CDATA[${this.textContent}]]>`;
+      if (this.tagName === "#cdata-section") return `<![CDATA[${this.nodeValue}]]>`;
       const attrs = Object.entries(this.attributes).map(([key, val]) => `${key}="${val}"`).join(" ");
       return `<${this.tagName} ${attrs}${this.tagName === '?xml' ? '?' : ''}>`;
    }

package/src/query/check-element.js

@@ -1,9 +1,8 @@
 function checkElement(el,selector) {
    if(selector == undefined) return true
    if(el == null) return false
-   let {tag,classList,attribs,id,prev,ancestors,parents,prevAny} = selector
+   let {tag,classList,attributes,id,prev,ancestors,parents,prevAny} = selector
    if(typeof el === 'string') return false
-   if(el.isSpecial) return false
    if(id !== undefined && el.id === null) return false
    if(id && id !== el.id) return false
    if(tag && el.tagName === undefined) return false
@@ -13,7 +12,7 @@ function checkElement(el,selector) {
    else if(classList !== undefined) {
       if(classList.every(e => el.classList.contains(e)) === false) return false
    }
-   if(checkattributes(attribs,el) === false) return false
+   if(checkattributes(attributes,el) === false) return false
    if(checkElement(el.prev,prev) === false) return false
    if(checkAncestors(el.ancestors,ancestors) === false) return false
    if(checkParents(el.ancestors,parents) === false) return false