faltu

法爾圖

以 Mongo 風格對物件數組進行搜尋排序、過濾、限制和迭代。

安裝

在NodeJS中：

npm install faltu --save

對於其他項目，只需下載該文件並將其包含在您的頁面中：

 < script src =" faltu.min.js " > </ script > 

用法

所有傳遞的資料都應該是數組或物件。

例如：

 [array, array, ..., array]

所有傳回的資料也是同一型別。

例如：

 var data = [ {
  name : "John" ,
  age : 16
} , {
  name : "Doe" ,
  age : 18
} , {
  name : "Smith" ,
  age : 22
} ] ;

將數組傳遞給建構函數：

在NodeJS中：

 var Faltu = require ( 'faltu' ) ;
var faltuData = new Faltu ( data ) ;

在其他環境下：

 var faltuData = new Faltu ( data ) ;

搜尋中

您可以使用find方法進行搜尋。搜尋所有 18 歲以下的男性：

 var newData = new Faltu ( data ) . find ( {
  age : 18
} ) . get ( ) ;

newData看起來像：

 [ {
  name : "Doe" ,
  age : 18
} ]

如果你想要傳回一個數組，你應該總是在最後呼叫get 。或者它只會回傳faltu實例。

搜尋所有年滿 18 歲或以上的男性：

 var newData = new Faltu ( data ) . find ( {
  age : {
    $gte : 18 // $gte is similar to >= (greater than or equal to)
  }
} ) . get ( ) ;

newData ：

 [ {
  name : "Doe" ,
  age : 18
} , {
  name : "Smith" ,
  age : 22
} ]

find中其他支援的比較運算子有：

• $lt ：<
• $lte ：<=
• $gt ：>
• $ne ：！

搜尋所有 18 歲或 16 歲的男性：

 var newData = new Faltu ( data ) . find ( {
  age : [ 16 , 18 ]
} ) . get ( ) ;

newData ：

 [ {
  name : "John" ,
  age : 16
} , {
  name : "Doe" ,
  age : 18
} ]

傳遞null 、空物件{}或不find任何內容表示不執行任何搜尋。 find接受選項作為第二個參數。

例如：

 var newData = new Faltu ( data ) . find ( {
  age : [ 16 , 18 ]
} , {
  sort : {
    age : - 1
  }
} ) . get ( ) ;

將按age降序傳回資料。除了sort之外，您還可以傳遞：

• skip
• limit
• unique

排序

使用sort將結果依age降序排序：

 var newData = new Faltu ( data ) . find ( {
  age : [ 16 , 18 ]
} ) . sort ( {
  age : - 1 // 1 = ASC, -1 = DESC
} ) . get ( ) ;

newData ：

 [ {
  name : "Doe" ,
  age : 18
} , {
  name : "John" ,
  age : 16
} ]

限制

讓我們只回傳 1 個物件：

 var newData = new Faltu ( data ) . find ( ) . limit ( 1 ) . get ( ) ;

newData ：

 [ {
  name : "John" ,
  age : 16
} ]

跳過

讓我們跳過第一個物件：

 var newData = new Faltu ( data ) . find ( ) . skip ( 1 ) . get ( ) ;

newData ：

 [ {
  name : "Doe" ,
  age : 18
} , {
  name : "Smith" ,
  age : 22
} ]

跳過和限制

讓我們跳過第一個物件：

 var newData = new Faltu ( data ) . find ( ) . skip ( 1 ) . limit ( 1 ) . get ( ) ;

newData ：

 [ {
  name : "Doe" ,
  age : 18
} ]

獨特的

您可以透過鍵傳回唯一的結果。

 var newData = new Faltu ( data ) . find ( ) . unique ( 'age' ) . get ( ) ;

濾

您也可以自己執行jQuery式過濾。呼叫filter方法，傳遞一個function 。

 var newData = new Faltu ( data ) . find ( ) . filter ( function ( person ) {
  return person . age == 16 ; // return true if you want to keep the object
} ) . get ( ) ;

newData ：

 [ {
  name : "John" ,
  age : 16
} ]

迭代

each都會迭代返回的所有記錄。

 var newData = new Faltu ( data ) . find ( null ) . each ( function ( person , index ) {
  console . log ( 'User name:' , person . name ) ;
} ) ;