Carcinogenic Agents - List of Classifications

carcinogen-list-classification is a package that provides a javascript function that returns an array of objects containing information about all the carcicogenic agents (substances that can cause cancer) according to the IARC Monographs.

Carcinogens are clasified into 5 groups:

| Group | What does it mean? | | ------------- |------------------------------| | 1 | Carcinogenic to humans | | 2A | Probably carcinogenic to humans| | 2B | Possibly carcinogenic to humans| | 3 | Carcinogenity not classifiable | | 4 | Probably not carcinogenic |

The information provided by this list includes:

• Agent
• Group
• Volume
• Volume publication year
• Evaluation year
• Additional information

Example of the returned data:

[
  {
    agent: "Perfluorooctanoic acid (PFOA)",
    group: "1",
    volume: "110, 135",
    volumePublicationYear: "2025 online",
    evaluationYear: "2023",
    additionalInformation: ""
  },
  ...
]

How to install the package

The Carcinopgenic Agents - List of Classifications package can be installed with npm:

npm install carcinogen-list-classification

How to retrieve the information

The package can be imported in the code using require or import:

const { carcinogenListSearch } = require('carcinogen-list-classification')

import { carcinogenListSearch } from 'carcinogen-list-classification'

To get the information run the following, where <SEARCH_OPTIONS> is a Javascript object that contains the configuration for the search:

const list = carcinogenListSearch( <SEARCH_OPTIONS> )

Options

| Name | Type | Default | Description | | ------------- | ------------- |------------------|------------------| | groups | array | ["1", "2A", "2B", "3", "4"] | Returns carcinogens belonging to the specified groups. The groups are: "1", "2A", "2B", "3", "4". | | sortBy | string | "group"| Sorts by the specified field. The possible fields are "agent", "group", "volume", "volumePublicationYear", "evaluationYear", "additionalInformation"| | sortMethod | string | "asc"| How to sort the search, can be ascendant or descendant. Possible options are "asc" and "desc". | | keywords | array | [""] | Returns carcinogens that contains the specified keywords. If none are provided, it returns all. |

Examples

// Returns all the list
carcinogenListSearch({})

// Only carcinogens belonging to groups 3 and 4
carcinogenListSearch({ groups: ["3", "4"] })

// Only carcinogens containing the keyword "virus" belonging to group 1
carcinogenListSearch({ keywords: ["virus"], groups: ["1"] })

// Sort the result by agent name in descending order and returns only carcinogens belonging to group 2A
carcinogenListSearch({ sortBy: "agent", sortMethod: "desc", groups: ["2A"] })