JSINQ - LINQ to Objects for JavaScript

Source code checked in, #76924

Project Collection Service Accounts — Mon, 01 Oct 2012 21:29:18 GMT

Upgrade: New Version of LabDefaultTemplate.xaml. To upgrade your build definitions, please visit the following link: http://go.microsoft.com/fwlink/?LinkId=254563

Source code checked in, #76923

Project Collection Service Accounts — Mon, 01 Oct 2012 21:23:54 GMT

Checked in by server upgrade

Reviewed: JSINQ 1.0.0.2 (Dec 26, 2011)

xocoatzin — Mon, 26 Dec 2011 19:40:50 GMT

Rated 5 Stars (out of 5) - This little framework saved me a lot of time when writing a report system by filtering out data coming from ajax requests

New Post: Need an elaborate example with datasets declaration

shirsath44 — Wed, 07 Sep 2011 11:11:52 GMT

Hi,

I am trying to use the JQINQ in my code but am unable to run it succesfully. I have added the library files to the project. I already have jquery libraries added to the pages. I have a data container like

var dataContainer[0] = {id:1, name:'allen'}

var dataContainer[1] = {id:2, name:'John'}

var dataContainer[2] = {id:3, name:'Paul'}

Can I use this as a dataset for querying like:

var query = new jsinq.Query("from g1 in $0 select {id:g1.id ,name: g1.name} ");

query.setValue(0, dataContainer);

var filterCustomers = query.execute();

Can somebody please post an example with datasets declared/defined??

Thanks,

Sagar

Updated Wiki: Frequently asked questions

kaijaeger — Wed, 04 Aug 2010 06:50:49 GMT

Q: How fast is JSINQ?

A: JSINQ's "Enumerable" implementation is not optimized for speed, but it is still reasonably fast, i.e. for the kind of datasets you deal with in a typical JavaScript application, the performance of JSINQs "Enumerable" implementation should be more than adequate. JSINQs query-compiler on the other hand is relatively slow, but since queries are generally compiled once and then never again, the impact of the query compilation on the overall performance of a JavaScript application should again be negligible. If you run into performance problems when using JSINQ, make sure your queries are defined in a scope where they are not compiled over and over again.

Q: Is JSINQ ready for production use?

A: Yes, for the most part! The "Enumerable" part of JSINQ is reasonably well-tested and is generally considered to be "safe" but the query compiler is still in a rather "experimental" stage. What you should note though is that if the query compiler produces correct output for a specific query, it is very likely to continue to do so in the future. In other words: bugs in the query compiler are likely to show up early and if a query compiles without errors once, it will not fail the second time (barring the influence of cosmic rays).

Q: Is JSINQ prone to "SQL injections"?

A: You mean JSINQ-injections? Yes it is, but only if you are doing it wrong! Since you specify your queries as strings, they are theoretically prone to the same kind of injection-type attacks that you get with SQL, but only if you are piecing together your queries with unvalidated strings that you somehow obtain from the user. Of course that is absolutely not how you should write your queries. If you have to get variables into your query, use placeholders! Placeholders are not replaced textually, i.e. you can't hijack a JSINQ query using a bad string passed in via a placeholder. Also, since JSINQ runs on the client, even if it was prone to injection-type attacks, it wouldn't really matter because you should never trust anything that comes from the client, ever.

Q: Is JSINQ better than jQuery, Prototype,...?

A: No. JSINQ is not a general-purpose JavaScript framework, it is not a widget library, it is not an Ajax framework and it doesn't try to be any of those things. You can easily combine JSINQ with those frameworks though.

Q: Does JSINQ support nested queries?

A: Theoretically: yes. You can assign query objects to placeholders or you can even define nested queries inline using anonymous functions.

Q: What does JSINQ stand for?

A: JavaScript INtegrated Query. And yes, it's a misnomer because JSINQ isn't really integrated into JavaScript at all.

Q: Is there a "JSINQ to XML"?

A: If by that you mean a JavaScript equivalent of LINQ to XML, then no. But there should be and you should probably be the one to write it (let me know if you do).

Q: How do you pronounce JSINQ?

A: I pronounce it Jay-Sink, but you may also pronounce it Jay-Ess-Ink or Ja-Zink (the sound a broken cash register makes).

Updated Wiki: Home

kaijaeger — Wed, 04 Aug 2010 06:49:38 GMT

JSINQ 1.0 out now!

JSINQ 1.0, the first stable release of JSINQ is available for download right now! It is packed with new features such as

Support for all .NET 3.5 query operators
Experimental support for the .NET 4.0 query operator "zip"
100% lazy (uses deferred execution)
Complete, fully tested implementations of System.Collections.Generic.List and System.Collections.Generic.Dictionary
toList, toDictionary and toLookup now available for jsinq.Enumerable
Still only 23 KB when minified

What is JSINQ?

JSINQ is the JavaScript library that allows you to write SQL-like queries against arrays and DOM node lists.
JSINQ is a complete implementation of LINQ to Objects (the .NET 4.0 version) in JavaScript. What that means is that if you know LINQ and you know JavaScript, you know JSINQ. JSINQ is both an API-compatible implementation of System.Linq.Enumerable and a complete query-expression compiler. That's right: you can write LINQ-style queries in JavaScript. And if that isn't enough: JSINQ is also very liberally licensed, well-document, well-tested (the Enumerable-part) and a stable version has just been released. So give it a go!

What does it look like?

Let's say you have a list of customers and you want to assemble a list of your customers' lastnames, ordered by their frequency. With JSINQ, you can write something like this:

var result = 
    customers.groupBy(function(customer) { 
        return customer.lastname; 
    }).
    select(function(g) { 
        return {lastname: g.key, count: g.count()}; 
    }).
    orderByDescending(function(r) { 
        return r.count; 
    });

This will do the job, but it's also rather difficult to read. That's why JSINQ also lets you write the following:

var query = new jsinq.Query('\
    from customer in $0 \
    group customer by customer.lastname into g \
    select {lastname: g.key, count: g.count()} \
    into r \
    orderby r.count descending \
    select r \
');

query.setValue(0, customers);
var result = query.execute();

Confused? What's with all the backslashes? Please read: JSINQ in a nutshell.

What can I do with JSINQ?

Write arbitrarily complex queries against JavaScript arrays, DOM node lists or your own enumerable types
Find elements in the HTML DOM tree using SQL-like queries
Dynamically create HTML elements from JSON you have received via XMLHttpRequest in a declarative manner
Tinker with XML and turn it into something else
Combine it in interesting ways with the JavaScript-/Ajax-frameworks you are already using
Write less code by exploiting the power of declarative programming
And for the ambitious: write raytracers, monadic parser combinators, etc.

Using JSINQ

JSINQ in a nutshell (new to JSINQ?, read this!)
JSINQ Documentation
Frequently asked questions

Previous work

JSINQ isn't the first attempt at implementing LINQ in JavaScript. There is also Chris Pietschmann's LINQ to JavaScript (right here on CodePlex), there is jLINQ and then there is this.

Closed Issue: EqualityComparer error [5326]

kaijaeger — Wed, 04 Aug 2010 06:39:54 GMT

I tryed to use distinct with equalityComparer without any luck.
When I saw the jsinq.js, I found an error on line 105, in the "EqualityComparer.fromFunction".
For some reason, the code is "comparer.compare = func;" where I think it must be "comparer.equals = func;"
With this change, the comparer do work.
Comments:

Solved.

Commented Issue: EqualityComparer error [5326]

kaijaeger — Wed, 04 Aug 2010 06:39:19 GMT

Thank you for reporting this! This has been resolved in JSINQ 1.0.0.2.

Updated Release: JSINQ 1.0.0.2 (Apr 04, 2010)

kaijaeger — Wed, 04 Aug 2010 06:38:40 GMT

Minor bugfixes with the Enumerable and Dictionary implementations.

Released: JSINQ 1.0.0.2 (Apr 04, 2010)

Wed, 04 Aug 2010 06:38:40 GMT

Minor bugfixes with the Enumerable and Dictionary implementations.

Source code checked in, #51799

kaijaeger — Wed, 04 Aug 2010 06:36:39 GMT

Work-item #5326

Created Issue: EqualityComparer error [5326]

ndaz5 — Tue, 03 Aug 2010 15:37:58 GMT

Source code checked in, #49966

_TFSSERVICE — Mon, 19 Jul 2010 20:19:27 GMT

Checked in by server upgrade

New Post: If a field is null then Enumerable throws Exception

jwriley — Thu, 15 Jul 2010 15:14:18 GMT

If a field on an item within an Enumerable has a null field then when you come to enumerating the Enumerable it throws and InvalidOperationException with no real explanation of what is wrong. For example if the object is { id: 1, name: "James", someField: null }

I was previously using the beta version and when I started to use the new version some of my application stopped working. to get it to work I changed the null to false and it now works a treat. Is this desired behaviour??

Thanks,

James

Updated Wiki: Home

kaijaeger — Mon, 24 May 2010 09:06:37 GMT

JSINQ 1.0 out now!

JSINQ 1.0, the first stable release of JSINQ is available for download right now! It is packed with new features such as

Support for all .NET 3.5 query operators
Experimental support for the .NET 4.0 query operator "zip"
100% lazy (uses deferred execution)
Complete, fully tested implementations of System.Collections.Generic.List and System.Collections.Generic.Dictionary
toList, toDictionary and toLookup now available for jsinq.Enumerable
Still only 23 KB when minified

What is JSINQ?

What does it look like?

Let's say you have a list of customers and you want to assemble a list of your customers' lastnames, ordered by their frequency. With JSINQ, you can write something like this:

var result = 
    customers.groupBy(function(customer) { 
        return customer.lastname; 
    }).
    select(function(g) { 
        return {lastname: g.key, count: g.count()}; 
    }).
    orderByDescending(function(r) { 
        return r.count; 
    }).
    select(function(r) { 
        return r; 
    });

This will do the job, but it's also rather difficult to read. That's why JSINQ also lets you write the following:

var query = new jsinq.Query('\
    from customer in $0 \
    group customer by customer.lastname into g \
    select {lastname: g.key, count: g.count()} \
    into r \
    orderby r.count descending \
    select r \
');

query.setValue(0, customers);
var result = query.execute();

Confused? What's with all the backslashes? Please read: JSINQ in a nutshell.

What can I do with JSINQ?

Write arbitrarily complex queries against JavaScript arrays, DOM node lists or your own enumerable types
Find elements in the HTML DOM tree using SQL-like queries
Dynamically create HTML elements from JSON you have received via XMLHttpRequest in a declarative manner
Tinker with XML and turn it into something else
Combine it in interesting ways with the JavaScript-/Ajax-frameworks you are already using
Write less code by exploiting the power of declarative programming
And for the ambitious: write raytracers, monadic parser combinators, etc.

Using JSINQ

JSINQ in a nutshell (new to JSINQ?, read this!)
JSING Documentation
Frequently asked questions

Previous work

JSINQ isn't the first attempt at implementing LINQ in JavaScript. There is also Chris Pietschmann's LINQ to JavaScript (right here on CodePlex), there is jLINQ and then there is this.

Updated Wiki: Home

kaijaeger — Thu, 13 May 2010 09:41:26 GMT

JSINQ 1.0 out now!

JSINQ 1.0, the first stable release of JSINQ is available for download right now! It is packed with new features such as

Support for all .NET 3.5 query operators
Experimental support for the .NET 4.0 query operator "zip"
Complete, fully tested implementations of System.Collections.Generic.List and System.Collections.Generic.Dictionary
toList, toDictionary and toLookup now available for jsinq.Enumerable
Still only 23 KB when minified

What is JSINQ?

What does it look like?

Let's say you have a list of customers and you want to assemble a list of your customers' lastnames, ordered by their frequency. With JSINQ, you can write something like this:

var result = 
    customers.groupBy(function(customer) { 
        return customer.lastname; 
    }).
    select(function(g) { 
        return {lastname: g.key, count: g.count()}; 
    }).
    orderByDescending(function(r) { 
        return r.count; 
    }).
    select(function(r) { 
        return r; 
    });

This will do the job, but it's also rather difficult to read. That's why JSINQ also lets you write the following:

var query = new jsinq.Query('\
    from customer in $0 \
    group customer by customer.lastname into g \
    select {lastname: g.key, count: g.count()} \
    into r \
    orderby r.count descending \
    select r \
');

query.setValue(0, customers);
var result = query.execute();

Confused? What's with all the backslashes? Please read: JSINQ in a nutshell.

What can I do with JSINQ?

Write arbitrarily complex queries against JavaScript arrays, DOM node lists or your own enumerable types
Find elements in the HTML DOM tree using SQL-like queries
Dynamically create HTML elements from JSON you have received via XMLHttpRequest in a declarative manner
Tinker with XML and turn it into something else
Combine it in interesting ways with the JavaScript-/Ajax-frameworks you are already using
Write less code by exploiting the power of declarative programming
And for the ambitious: write raytracers, monadic parser combinators, etc.

Using JSINQ

JSINQ in a nutshell (new to JSINQ?, read this!)
JSING Documentation
Frequently asked questions

Previous work

JSINQ isn't the first attempt at implementing LINQ in JavaScript. There is also Chris Pietschmann's LINQ to JavaScript (right here on CodePlex), there is jLINQ and then there is this.

New Post: Is sum supposed to fail when empty?

loraderon — Tue, 06 Apr 2010 11:41:37 GMT

Hi,

The new release works great!

Thanks for the quick fix.

New Post: Is sum supposed to fail when empty?

kaijaeger — Sun, 04 Apr 2010 17:31:50 GMT

Hi and thanks for reporting this issue,

you're absolutely right that sum() should not throw when invoked on an empty enumerable (unlike average, min and max).

Would you please download the new 1.0.0.1 release and let me know if this works for you?

Thanks and cheers,

Kai

Created Release: JSINQ 1.0.0.1 (Apr 04, 2010)

kaijaeger — Sun, 04 Apr 2010 17:28:10 GMT

Minor bugfixes with the Enumerable and Dictionary implementations.

Released: JSINQ 1.0.0.1 (Apr 04, 2010)

Sun, 04 Apr 2010 17:28:10 GMT

Minor bugfixes with the Enumerable and Dictionary implementations.