Skip to content

This package returns various information about a given USA state legislature- including the name of each chamber, the number of members, the term length by chamber, and whether the state has imposed term limits.

License

Notifications You must be signed in to change notification settings

christinepoydence/usa-state-legislatures

Repository files navigation

License: ISC Known Vulnerabilities Build Status Coverage Status Maintainability

usa-state-legislatures

This package returns various information about a given USA state legislature- including the name of each chamber, the number of members, the term length by chamber, and whether the state has imposed term limits.

Note: This repository just provides basic, publicly available information about US State Legislatures. It is not affiliated with any government entity.

Install

npm install usa-state-legislatures

Usage

Note: All methods in this package require a state to be passed. The state must be passed as a string, and either the full state name or the state abbreviation may be used. Case does not matter, and leading/trailing spaces will be ignored. For instance, all of the following inputs are valid for ther state of Ohio:

  • "Ohio"
  • "ohio"
  • " oHIo "
  • "OH"
  • " oh "

stateLegislatureName(stateName)

This method accepts a valid state as defined above and returns the state's legislature name, the name of it's upper chamber (usually Senate) and the name of it's lower chamber (usually House of Representatives). It is valid for:

  • All 50 states in the United States of America
const {stateLegislatures} = require("usa-state-legislatures")

const ohioLegislatureNames = stateLegislatures.stateLegislatureName('OH') 
console.log(ohioLegislatureNames)
//Would print the following JSON:
{
    "legislatureName": "General Assembly", 
    "lowerHouse": "House of Representatives", 
    "upperHouse": "Senate"
}

stateLegislatureMembers(stateName)

This method accepts a valid state as defined above and returns the state's legislative chambers and their member counts. It is valid for:

  • All 50 states in the United States of America
const {stateLegislatures} = require("usa-state-legislatures")

const ohioLegislatureMembers = stateLegislatures.stateLegislatureMembers('OH') 
console.log(ohioLegislatureMembers)
//Would print the following JSON:
{
    "House of Representatives": 99, 
    "Senate": 33
}

totalStateLegislativeMembers(stateName)

This method accepts a valid state as defined above and returns the state's legislative chambers and their member counts. It is valid for:

  • All 50 states in the United States of America
const {stateLegislatures} = require("usa-state-legislatures")

const ohioLegislatureMembers = stateLegislatures.totalStateLegislatureMembers('OH') 
console.log(ohioLegislatureMembers)
//Would print the following JSON:
{
    "House of Representatives": 99, 
    "Senate": 33,
    "totalStateLegislativeMembers": 132
}

stateLegislatureMembersByChamber(stateName, chamber)

This method accepts a valid state as defined above and a legislative chamber and returns the number of members in that chamber. It is valid for:

  • All 50 states in the United States of America

Valid inputs for the chamber include:

  1. 'upper' for the upper legislative chamber (usually the Senate)
  2. 'lower' for the lower legislative chamber (usually the House)
  3. 'senate' for the upper legislative chamber
  4. 'house' for the lower legislative chamber
  5. The actual name of the legislative chamber in that state. (Ex. 'House of Delegates' in Virginia)
  6. Nebraska has a unicameral legislature. To retrieve results for Nebraska, simply enter 'Legislature' as the chamber.

All inputs are case insensitive and will ignore leading/trailing spaces. The input must be a string.

const {stateLegislatures} = require("usa-state-legislatures")

const ohioLegislatureTermLengths = stateLegislatures.stateLegislatureMembersByChamber('OH','house') //returns 33
const virginiaLegislatureTermLengths = stateLegislatures.stateLegislatureMembersByChamber('Virginia','house of delegates') //returns 100
const nebraskaLegislatureTermLengths = stateLegislatures.stateLegislatureMembersByChamber('Nebraska','Legislature') //returns 49

stateLegislatureTermLength(stateName)

This method accepts a valid state as defined above and returns the state's legislative chambers and their member's term length in years. It is valid for:

  • All 50 states in the United States of America

Important Note: Some states have variable terms for their Senate in order to account for redistricting years. This information is not yet incorporated into this package.

const {stateLegislatures} = require("usa-state-legislatures")

const ohioLegislatureTermLengths = stateLegislatures.stateLegislatureTermLength('OH') 
console.log(ohioLegislatureMembers)
//Would print the following JSON:
{
    "House of Representatives": 2, 
    "Senate": 4
}

stateLegislatureTermLengthByChamber(stateName, chamber)

This method accepts a valid state as defined above and a legislative chamber and returns the member's term length in years for that chamber. It is valid for:

  • All 50 states in the United States of America

Valid inputs for the chamber include:

  1. 'upper' for the upper legislative chamber (usually the Senate)
  2. 'lower' for the lower legislative chamber (usually the House)
  3. 'senate' for the upper legislative chamber
  4. 'house' for the lower legislative chamber
  5. The actual name of the legislative chamber in that state. (Ex. 'House of Delegates' in Virginia)
  6. Nebraska has a unicameral legislature. To retrieve results for Nebraska, simply enter 'Legislature' as the chamber.

All inputs are case insensitive and will ignore leading/trailing spaces. The input must be a string.

Important Note: Some states have variable terms for their Senate in order to account for redistricting. These states return a Senate term length of 2-4-4.

const {stateLegislatures} = require("usa-state-legislatures")

const ohioLegislatureTermLengths = stateLegislatures.stateLegislatureTermLengthByChamber('OH','house') //returns 2
const virginiaLegislatureTermLengths = stateLegislatures.stateLegislatureTermLengthByChamber('Virginia','house of delegates') //returns 2
const nebraskaLegislatureTermLengths = stateLegislatures.stateLegislatureTermLengthByChamber('Nebraska','Legislature') //returns 4

statesWithTermLimits()

This method returns a list of all states in the USA that impose term limits on their state legislatures.

const {termLimits} = require("usa-state-legislatures")

const statesWithTermLimits = termLimits.statesWithTermLimits(); //returns a list of all states with term limits

doesStateHaveTermLimits(stateName)

This method accepts a valid state as defined above and returns whether the state imposes term limits on their state legislature. It is valid for:

  • All 50 states in the United States of America
const {termLimits} = require("usa-state-legislatures")

termLimits.doesStateHaveTermLimits("ohio"); //returns true
termLimits.doesStateHaveTermLimits("NY"); //returns false

About

This package returns various information about a given USA state legislature- including the name of each chamber, the number of members, the term length by chamber, and whether the state has imposed term limits.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published