# Conditionals

## Basic `if` and `else`

If you store the builder object in a variable, you can use `if` and `else` statements like you would expect.

```
var builder = builder.from( "posts" );
if ( rc.recent ) {
    builder.orderBy( "published_date", "desc" );
}
var results = builder.get();
```

This works, but breaks chainability. A better way is to use the `when` helper method.

## `when`

| Name      | Type    | Required | Default                     | Description                                                                                                   |
| --------- | ------- | -------- | --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| condition | boolean | true     |                             | The condition to switch on.                                                                                   |
| onTrue    | Closure | true     |                             | The callback to execute if the condition is true.  It is passed the `builder` object as the only parameter.   |
| onFalse   | Closure | false    | function( q ) { return q; } | The callback to execute if the conditions is false.  It is passed the `builder` object as the only parameter. |

We can rewrite the above query like so:

```
var results = builder.from( "posts" )
    .when( rc.recent, function( q ) {
        q.orderBy( "published_date", "desc" );
    } )
    .get();
```

Nice. We keep chainability this way and reduce the number of temporary variables we need.