Nationwide Polamorous Matrimony

    linq
    TypeScript icon, indicating that this package has built-in type declarations

    4.0.0 • Public • Published

    linq

    This is a JavaScript implementation of the .NET LINQ library.

    It contains all the original .NET methods plus a few additions.

    Written in pure JavaScript with no dependencies.

    Examples

    // C# LINQ - delegate
    Enumerable.Range(1, 10)
        .Where(delegate(int i) { return i % 3 == 0; })
        .Select(delegate(int i) { return i * 10; });
    
    // linq.js - anonymous function
    Enumerable.range(1, 10)
        .where(function(i) { return i % 3 == 0; })
        .select(function(i) { return i * 10; });
    // C# LINQ - lambda
    Enumerable.Range(1, 10).Where((i) => i % 3 == 0).Select((i) => i * 10);
    
    // linq.js - arrow function
    Enumerable.range(1, 10).where((i) => i % 3 == 0).select((i) => i * 10);
    // C# LINQ - anonymous type
    array.Select((val, i) => new { Value: val, Index: i }());
    
    // linq.js - object literal
    Enumerable.from(array).select((val, i) => ({ value: val, index: i }));

    See sample/tutorial.js and the test folder for more examples.

    Usage

    Node.js (ES modules)

    Install the latest version of the library with npm:

    npm install linq
    

    Load it in your code with the import syntax:

    import Enumerable from 'linq'
    
    let result = Enumerable.range(1, 10).where(i => i % 3 == 0).select(i => i * 10)
    console.log(result.toArray()) // [ 30, 60, 90 ]

    Because the library is an ES module, this code will only work if your project is also configured as an ES module. Add the following line in your package.json to make it an ES module:

    "type": "module"

    If you're not planning to use ES modules, check the CommonJS section below.

    Node.js (CommonJS modules)

    Install version 3 of this library:

    npm install linq@3
    

    Load it with the require syntax:

    const Enumerable = require('linq')
    
    let count = Enumerable.range(1, 10).count(i => i < 5)
    console.log(count) // 4

    The cjs branch contains the source code for the CommonJS version of the library.

    TypeScript

    Install the latest version of the library with npm.

    Configure your compiler options in tsconfig.json

    "compilerOptions": {
        "target": "ES2020",
        "moduleResolution": "node"
    }

    The library comes with a d.ts file containing type definitions for all the objects and methods, feel free to use them in your code:

    import Enumerable from 'linq';
    
    type tnum = Enumerable.IEnumerable<number>;
    let x: tnum = Enumerable.from([1, 2, 3]);

    Deno

    Install the latest version of the library with npm.

    Use the full file path when importing the library. Also use the @deno-types annotation to load type definitions:

    // @deno-types="./node_modules/linq/linq.d.ts"
    import Enumerable from './node_modules/linq/linq.js'
    
    let radius = Enumerable.toInfinity(1).where(r => r * r * Math.PI > 10000).first()

    Browser

    The minified version of the library is available in the release archive.

    Load it via <script type="module">:

    <script type="module" src="./linq.min.js"></script>
    <script type="module">
        import Enumerable from './linq.min.js'
        Enumerable.from([1, 2, 3]).forEach(x => console.log(x))
    </script>

    You can also load the library via a CDN:

    CDN URL
    unpkg https://unpkg.com/linq/
    jsDelivr https://jsdelivr.com/package/npm/linq
    packd https://bundle.run/linq@latest?name=linq

    Credits

    Yoshifumi Kawai developed the original version of this library, currently no longer maintained.

    License

    MIT License

    Keywords

    Install

    npm i linq

    DownloadsWeekly Downloads

    24,256

    Version

    4.0.0

    License

    MIT

    Unpacked Size

    164 kB

    Total Files

    6

    Last publish

    Collaborators

    • mihaifm