A Rails plugin to add more support for javascript files.
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
tasks
.gitignore
MIT-LICENSE
README.rdoc
Rakefile
TODO
init.rb

README.rdoc

JavaScript Fu Rails Plugin

This plugin adds helpers, rake tasks, and rspec matchers for JavaScript development.

Installation

git clone git://github.com/osteele/javascript_fu.git vendor/plugins/javascript_fu

Extended Rake Tasks

The existing notes and statistics tasks are extended to compass the public/javascript directory:

rake statistics
rake notes

New View Helper

The new onload generator method generates code that executes the content of the block upon the completion of page load.

page.onload do
  page.call alert', 'page loaded!'
end

generates

Event.observe("window", "load", function() { alert("page loaded!"); });

or

$(document).ready(function() { alert("page loaded!"); });

New RSpec Matcher

Use these in your specs to verify that a view is calling a JavaScript function:

response.should call_js('fn')
response.should call_js('fn(true)')
response.should call_js('gApp.setup')

If there is a body, the arguments to the call are parsed (as JSON) and passed to it:

# response includes <script>...fn('string', 2)...</script>
response.should call_js(fn') do |args|
  args.should == ['string', 2]
end

If the “JCON” gem is installed, you can use this to test arguments values against ECMAScript 4.0 types:

'<script>fn("id", {x:1, y:2}, true)</script>'.should call_js('fn') do |args|
  args[0].should conform_to_js('string')
  args[1].should conform_to_js('{x:int, y:int}')
  args[2].should conform_to_js('boolean')
  # or:
  args.should conform_to_js('[string, {x:int, y:int}, boolean]')
end

License

Copyright 2008 by Oliver Steele. All rights reserved. Released under the MIT License.