A JavaScript micro-library for cricket scoring created for use in cricket scoring applications and cricket games that require scoring. The library is incredibly flexible allowing for different rules sets, match lengths and includes options for recording the pitch of the ball while bowling and where the ball goes while batting. This can provide useful statistics and allow the creation of wagon wheels and the like.

This work is licensed under a Attribution-NonCommercial-ShareAlike 4.0 International license.

Please make contributions by forking the project and creating a pull-request. Other contributions include maintaining the Wiki and issues.

If you have used this library, email me and tell me how you have used it because I'd like to provide links to showcase your projects 😄.

Reference the raw Github version of release.min.js in your code.

Scorebook is compatible with requireJS and can be used by wrapping your code in the following block:

require(['scorebook'], function (scorebook) {
	// Your code.
});

Scorebook is also available as a node package called "scorebook". You can install it to your local repository using npm install scorebook --save and you can use the library with node by using var scorebook = require("scorebook").scorebook; in your JavaScript file.

This project is maintained under the semantic versioning guidlines. This means that releases will have the following format <major>.<minor>.<patch>.

• Breaking backward compatibility bumps the major (and resets the minor and patch).
• New additions without breaking backward compatibility bumps the minor (and resets the patch).
• Bug fixes and misc changes bumps the patch.

To create a new scorebook, use the global "scorebook" function.

book = scorebook();

Arguments None.

Returns {Object} scorebook: A structure that can be manipulated like a scorebook.

Creates a new innings in the scorebook.

book.addInnings(battingTeam);

Arguments

• {Object} battingTeam: The team batting the innings.

Returns {Object} scorebook: A structure that can be manipulated like a scorebook.

Creates a new over in the scorebook for the current innings.

book.addOver(bowler);

Arguments

• {Object} bowler: The player bowling the over.

Returns {Object} scorebook: A structure that can be manipulated like a scorebook.

Creates a new ball in the scorebook for the current over.

book.addBall(runs, batsman, {
	wideBall: false,
	noBall: false,
	byes: false,
	legByes: false,
	wagonX: 0,
	wagonY: 0,
	pitchX: 0,
	pitchY: 0,
	batPen: 0,
	bwlPen: 0
});

Arguments

• {Number} runs: The number of runs.
• {Object} batsman: The player that faced the ball.
• {Object} opts: Additonal options.
  • {Boolean} wideBall: Determines if a wide was bowled.
  • {Boolean} noBall: Determines if a no ball was bowled.
  • {Boolean} byes: Determines if the ball did not hit the bat/leg and scored runs.
  • {Boolean} legByes: Determines if the ball hit the leg and scored runs.
  • {Number} wagonX: A number that locates where the ball was hit to on the x-axis.
  • {Number} wagonY: A number that locates where the ball was hit to on the y-axis.
  • {Number} pitchX: A number that locates where the ball landed on the x-axis.
  • {Number} pitchY: A number that locates where the ball landed on the y-axis.
  • {Number} batPen: The number of penalty runs incurred by the batting team.
  • {Number} bwlPen: The number of penalty runs incurred by the bowling team.

Returns {Object} scorebook: A structure that can be manipulated like a scorebook.

Creates a new wicket in the scorebook for the current ball. Ensure that you have added the ball before adding the wicket.

book.addWicket(batsman, howOut[, fielder]);

Arguments

• {Object} batsman: The player that was given out.
• {String} howOut: How the batsman got out.
• {Object} fielder: The player that assisted/took the wicket in the field.

Returns {Object} scorebook: A structure that can be manipulated like a scorebook.

Gets innings from the scorebook.

book.getInnings(inning);

Arguments

• {Object} inning: An object that resembles (shares properties with) wanted innings.

Returns {Array} innings: An array of innings that resemble the given object (inning).

Gets overs from the scorebook.

book.getOvers(over);

Arguments

• {Object} over: An object that resembles (shares properties with) wanted overs.

Returns {Array} overs: An array of overs that resemble the given object (over).

Gets balls from the scorebook.

book.getBalls(ball);

Arguments

• {Object} ball: An object that resembles (shares properties with) wanted balls.

Returns {Array} balls: An array of balls that resemble the given object (ball).

Gets wickets from the scorebook.

book.getWickets(wicket);

Arguments

• {Object} wicket: An object that resembles (shares properties with) wanted wickets.

Returns {Array} wickets: An array of wickets that resemble the given object (wicket).

Undoes the last action.

book.undo();

Arguments None.

Returns {Object} scorebook: A structure that can be manipulated like a scorebook.

• {Array} innings: An array of innings contained in the scorebook.
• {Array} overs: An array of overs contained in the scorebook.
• {Array} balls: An array of balls contained in the scorebook.
• {Array} wickets: An array of wickets contained in the scorebook.