)
)
const Block = memo(({ methodData, setForceShowTest, id, openModal }) =>
Object.keys(methodData)
.filter(variant => !['notes', 'resources', 'spec'].includes(variant))
.map(variant => (
))
)
export default memo(({ methodData, showTests, id, openModal }) => {
const [forceShowTest, setForceShowTest] = useState(false)
return (
{methodData.spec && (showTests || forceShowTest) ? (
) : null}
)
})
================================================
FILE: src/components/ContentBlock.js
================================================
import styled from 'styled-components'
const Content = styled.div`
padding: 3em 3em 1em;
max-width: 50em;
margin: auto;
h1 {
font-size: 2.6rem;
strong {
font-size: clamp(3.9rem, -0.875rem + 8.333vw, 5.2rem);
display: block;
}
}
& + & {
padding-top: 0;
}
a del {
font-size: 85%;
color: var(--nc-tx-2);
}
p {
line-height: 1.8;
}
`
export default Content
================================================
FILE: src/components/Embed.js
================================================
import React from 'react'
import codesandboxUrls from '../code-sandbox.json'
import styled from 'styled-components'
const Embed = styled.iframe`
width: 100%;
height: 100%;
border: 0;
position: relative;
`
export default ({ id }) => {
console.log(id)
const url = codesandboxUrls[id]
return (
)
}
================================================
FILE: src/components/Footer.js
================================================
import React from 'react'
import Content from './ContentBlock'
export default ({ footer }) => (
)
================================================
FILE: src/components/Heading.js
================================================
import React from 'react'
import styled from 'styled-components'
const Heading = styled.h1`
text-transform: capitalize;
margin: auto;
text-align: ${({ hierarchy }) =>
parseInt(hierarchy, 10) < 3 ? 'center' : 'left'};
`
export default ({ hierarchy, children }) => (
{children}
)
================================================
FILE: src/components/LibPage.js
================================================
import React, { Fragment, useCallback, useState, memo, useEffect } from 'react'
import ScrollToTop from 'react-scroll-up'
import styled from 'styled-components'
import Content from './ContentBlock'
import AnchoredBlock from './AnchoredBlock'
import Search from './Search'
import CodeComparison from './CodeComparison'
import dataFilter from '../helpers/data-filter'
import ShowTests from './ShowTests'
import Modal from './Modal'
const Row = styled.div`
background: var(--nc-bg-1);
padding: 3em;
&:nth-child(2n) {
background: var(--nc-bg-2);
border-bottom: 1px solid var(--nc-bg-2);
}
`
const Section = memo(({ method, data, section, showTests, frw, openModal }) => (
))
const Block = memo(({ data, showTests, section, frw, openModal }) =>
Object.keys(data).map(method => (
))
)
export default memo(({ data: initialData, frw }) => {
const [showTests, setShowTests] = useState(false)
const [value, setValue] = useState('')
const [data, setData] = useState(initialData)
const [embed, setEmbed] = useState()
const onChange = useCallback(
({ target: { value } }) => {
setValue(value)
setData(dataFilter(initialData, value))
},
[initialData]
)
useEffect(() => {
setShowTests(false)
setValue('')
setData(initialData)
}, [initialData])
const showTestsToggle = useCallback(
() => setShowTests(showTests => !showTests),
[]
)
const closeModal = useCallback(() => setEmbed(), [])
const openModal = useCallback(id => setEmbed(id), [])
return (
{Object.keys(data).map(section => (
))}
🔝
)
})
================================================
FILE: src/components/Modal.js
================================================
import React, { memo, Suspense, lazy } from 'react'
import Modal from 'react-modal'
import styled from 'styled-components'
import { isMobile } from 'is-mobile'
const EmbedComponent = lazy(() => import('./Embed'))
Modal.setAppElement('#modal-root')
const Loader = styled.div`
width: 100%;
height: 100%;
background: rgba(255, 255, 255, 0.9);
@keyframes spinner {
to {
transform: rotate(360deg);
}
}
&:before {
content: '';
box-sizing: border-box;
position: absolute;
z-index: 0;
top: 50%;
left: 50%;
width: 20px;
height: 20px;
margin-top: -10px;
margin-left: -10px;
border-radius: 50%;
border: 2px solid #ccc;
border-top-color: #000;
animation: spinner 0.6s linear infinite;
}
`
const CloseBtn = styled.button`
z-index: 10;
border: 0;
cursor: pointer;
background: #222;
border-radius: 50px;
display: inline-block;
width: 20px;
height: 20px;
overflow: hidden;
text-decoration: none;
padding: 0;
font-size: 10px;
color: white;
line-height: 2;
box-shadow: 1px 1px 3px #999;
position: absolute;
right: -10px;
top: -10px;
span {
text-indent: 100px;
}
&::before {
content: '✕';
display: block;
}
`
const style = {
overlay: {
zIndex: 1000,
background: 'rgba(0,0,0,.5)',
},
content: {
overflow: 'visible',
color: 'black',
background: 'none',
border: 0,
padding: 0,
right: 'calc(2vw + 10px)',
top: 'calc(2vw + 10px)',
left: 'calc(2vw + 10px)',
bottom: 'calc(2vw + 10px)',
},
}
const useScrollBodyLock = () => {
const lock = () => {
if (isMobile()) {
const scrollY = `${window.scrollY}px`
const body = document.body
body.style.position = 'fixed'
body.style.top = `-${scrollY}`
return
}
}
const unlock = () => {
if (isMobile()) {
const body = document.body
const scrollY = body.style.top
const parsedScrollY = parseInt(scrollY || '0') * -1
body.style.position = ''
body.style.top = ''
if (parsedScrollY) {
window.scrollTo(0, parseInt(scrollY || '0') * -1)
}
return
}
}
return { lock, unlock }
}
export default memo(({ close, id }) => {
const { lock, unlock } = useScrollBodyLock()
return (
close
{id && (
}>
)}
)
})
================================================
FILE: src/components/Nav.js
================================================
import React, { memo } from 'react'
import Link from 'next/link'
import { useRouter } from 'next/router'
import Badge from './Badge'
export default memo(({ themeToggler }) => {
const router = useRouter()
return (
)
})
================================================
FILE: src/components/Page.js
================================================
import React, { Fragment } from 'react'
import Head from 'next/head'
import Content from './ContentBlock'
import Footer from './Footer'
export default ({ content, title, children, footer, siteRoot }) => (
{title}
{children}
)
================================================
FILE: src/components/ResponsiveVideo.js
================================================
import React from 'react'
import styled from 'styled-components'
import Content from './ContentBlock'
const VideoContainer = styled.div`
margin: auto;
position: relative;
padding-bottom: 56.25%;
padding-top: 35px;
height: 0;
overflow: hidden;
iframe {
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
}
`
export default ({ title, embedUrl }) => (
)
================================================
FILE: src/components/Search.js
================================================
import React from 'react'
import styled from 'styled-components'
const Input = styled.input`
width: 100%;
padding: 0.5em;
font-size: 120%;
`
export default props =>
================================================
FILE: src/components/ShowTests.js
================================================
import React, { memo } from 'react'
import styled from 'styled-components'
const ShowTests = styled.div`
text-align: right;
`
export default memo(({ onChange, checked }) => (
))
================================================
FILE: src/components/Spec.js
================================================
import React from 'react'
import styled from 'styled-components'
import Hightlight from 'react-highlight/lib/optimized'
import Heading from './Heading'
const Tests = styled.div`
padding-bottom: 4em;
code {
display: block;
padding: 15px;
background: var(--custom-bk-code);
border: 0;
border-left: 3px solid var(--nc-lk-1);
border-radius: 0;
}
`
export default ({ code }) => (
Test{code}
)
================================================
FILE: src/content/.eslintrc
================================================
{
"rules": {
"no-console": 0
}
}
================================================
FILE: src/content/css.md
================================================
# YOU MIGHT NOT NEED **CSS**
Sorry, this was clickbait.
This topic polarised the community in the last few years; you might have landed here either excited or frustrated – in which case I recommend reading [Why is CSS Frustrating?](https://css-tricks.com/why-is-css-frustrating/)
All I can offer is this talk, which helped me understand where some of the following [experiments](https://github.com/MicheleBertoli/css-in-js) came from. Arguably, some of the solutions out there aren't suitable for most use cases. But having a sense of why people invested in them and what problems they were trying to solve could prove helpful.
================================================
FILE: src/content/date-fns/00-generic/closestIndexTo/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/closestIndexTo
import { closestIndexTo } from 'date-fns'
// Which date is closer to 6 September 2015?
const dateToCompare = new Date(2015, 8, 6)
const datesArray = [
new Date(2015, 0, 1),
new Date(2016, 0, 1),
new Date(2017, 0, 1),
]
module.exports = closestIndexTo(dateToCompare, datesArray)
// => 1
================================================
FILE: src/content/date-fns/00-generic/closestIndexTo/notes.md
================================================
Return an index of the closest date from the array comparing to the given date.
================================================
FILE: src/content/date-fns/00-generic/closestIndexTo/spec.js
================================================
const expected = 1
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('closestIndexTo', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/closestIndexTo/vanilla.js
================================================
const closestIndexTo = (dateToCompare, datesArray) => {
const distances = datesArray.map(date => Math.abs(date - dateToCompare))
return distances.indexOf(Math.min(...distances))
}
// Which date is closer to 6 September 2015?
const dateToCompare = new Date(2015, 8, 6)
const datesArray = [
new Date(2015, 0, 1),
new Date(2016, 0, 1),
new Date(2017, 0, 1),
]
module.exports = closestIndexTo(dateToCompare, datesArray)
// => 1
================================================
FILE: src/content/date-fns/00-generic/closestTo/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/closestTo
import { closestTo } from 'date-fns'
// Which date is closer to 6 September 2015: 1 January 2000 or 1 January 2030?
const dateToCompare = new Date(2015, 8, 6)
module.exports = closestTo(dateToCompare, [
new Date(2000, 0, 1),
new Date(2030, 0, 1),
])
// => Tue Jan 01 2030 00:00:00
================================================
FILE: src/content/date-fns/00-generic/closestTo/notes.md
================================================
Return a date from the array closest to the given date.
================================================
FILE: src/content/date-fns/00-generic/closestTo/spec.js
================================================
const expected = new Date(2030, 0, 1)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('closestTo', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/closestTo/vanilla.js
================================================
const closestTo = (dateToCompare, datesArray) => {
const distances = datesArray.map(date => Math.abs(date - dateToCompare))
return datesArray[distances.indexOf(Math.min(...distances))]
}
// Which date is closer to 6 September 2015: 1 January 2000 or 1 January 2030?
const dateToCompare = new Date(2015, 8, 6)
module.exports = closestTo(dateToCompare, [
new Date(2000, 0, 1),
new Date(2030, 0, 1),
])
// => Tue Jan 01 2030 00:00:00
================================================
FILE: src/content/date-fns/00-generic/compareAsc/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/compareAsc
import { compareAsc } from 'date-fns'
// Compare 11 February 1987 and 11 February 1987:
exports.equal = compareAsc(new Date(1987, 1, 11), new Date(1987, 1, 11))
// => 0
// Compare 11 February 1987 and 10 July 1989:
exports.compare = compareAsc(new Date(1987, 1, 11), new Date(1989, 6, 10))
// => -1
// Sort the array of dates:
exports.sort = [
new Date(1995, 6, 2),
new Date(1987, 1, 11),
new Date(1989, 6, 10),
].sort(compareAsc)
// => [
// Wed Feb 11 1987 00:00:00,
// Mon Jul 10 1989 00:00:00,
// Sun Jul 02 1995 00:00:00
// ]
================================================
FILE: src/content/date-fns/00-generic/compareAsc/notes.md
================================================
Compare the two dates and return -1, 0 or 1.
================================================
FILE: src/content/date-fns/00-generic/compareAsc/spec.js
================================================
const expected = {
compare: -1,
equal: 0,
sort: [new Date(1987, 1, 11), new Date(1989, 6, 10), new Date(1995, 6, 2)],
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('compareAsc', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/compareAsc/vanilla.js
================================================
const compareAsc = (dateA, dateB) => {
if (dateA.getTime() === dateB.getTime()) return 0
return dateA > dateB ? 1 : -1
}
// Compare 11 February 1987 and 11 February 1987:
exports.equal = compareAsc(new Date(1987, 1, 11), new Date(1987, 1, 11))
// => 0
// Compare 11 February 1987 and 10 July 1989:
exports.compare = compareAsc(new Date(1987, 1, 11), new Date(1989, 6, 10))
// => -1
// Sort the array of dates:
exports.sort = [
new Date(1995, 6, 2),
new Date(1987, 1, 11),
new Date(1989, 6, 10),
].sort(compareAsc)
// => [
// Wed Feb 11 1987 00:00:00,
// Mon Jul 10 1989 00:00:00,
// Sun Jul 02 1995 00:00:00
// ]
================================================
FILE: src/content/date-fns/00-generic/compareDesc/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/compareDesc
import { compareDesc } from 'date-fns'
// Compare 11 February 1987 and 11 February 1987:
exports.equal = compareDesc(new Date(1987, 1, 11), new Date(1987, 1, 11))
// => 0
// Compare 11 February 1987 and 10 July 1989:
exports.compare = compareDesc(new Date(1987, 1, 11), new Date(1989, 6, 10))
// => -1
// Sort the array of dates in reverse chronological order:
exports.sort = [
new Date(1995, 6, 2),
new Date(1987, 1, 11),
new Date(1989, 6, 10),
].sort(compareDesc)
// => [
// Sun Jul 02 1995 00:00:00,
// Mon Jul 10 1989 00:00:00,
// Wed Feb 11 1987 00:00:00
// ]
================================================
FILE: src/content/date-fns/00-generic/compareDesc/notes.md
================================================
Compare the two dates reverse chronologically and return -1, 0 or 1.
================================================
FILE: src/content/date-fns/00-generic/compareDesc/spec.js
================================================
const expected = {
compare: 1,
equal: 0,
sort: [new Date(1995, 6, 2), new Date(1989, 6, 10), new Date(1987, 1, 11)],
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('compareDesc', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/compareDesc/vanilla.js
================================================
const compareDesc = (dateA, dateB) => {
if (dateA.getTime() === dateB.getTime()) return 0
return dateA > dateB ? -1 : 1
}
// Compare 11 February 1987 and 11 February 1987:
exports.equal = compareDesc(new Date(1987, 1, 11), new Date(1987, 1, 11))
// => 0
// Compare 11 February 1987 and 10 July 1989:
exports.compare = compareDesc(new Date(1987, 1, 11), new Date(1989, 6, 10))
// => -1
// Sort the array of dates in reverse chronological order:
exports.sort = [
new Date(1995, 6, 2),
new Date(1987, 1, 11),
new Date(1989, 6, 10),
].sort(compareDesc)
// => [
// Sun Jul 02 1995 00:00:00,
// Mon Jul 10 1989 00:00:00,
// Wed Feb 11 1987 00:00:00
// ]
================================================
FILE: src/content/date-fns/00-generic/isAfter/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isAfter
import { isAfter } from 'date-fns'
exports.before = isAfter(new Date(1987, 6, 10), new Date(1989, 1, 11))
// => true
exports.equal = isAfter(new Date(1989, 6, 10), new Date(1989, 6, 10))
// => false
exports.after = isAfter(new Date(1989, 6, 10), new Date(1987, 1, 11))
// => true
================================================
FILE: src/content/date-fns/00-generic/isAfter/notes.md
================================================
Is the first date after the second one?
================================================
FILE: src/content/date-fns/00-generic/isAfter/spec.js
================================================
const expected = {
before: false,
equal: false,
after: true,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isAfter', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isAfter/vanilla.js
================================================
const isAfter = (dateA, dateB) => dateA > dateB
exports.before = isAfter(new Date(1987, 6, 10), new Date(1989, 1, 11))
// => true
exports.equal = isAfter(new Date(1989, 6, 10), new Date(1989, 6, 10))
// => false
exports.after = isAfter(new Date(1989, 6, 10), new Date(1987, 1, 11))
// => true
================================================
FILE: src/content/date-fns/00-generic/isBefore/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isBefore
import { isBefore } from 'date-fns'
exports.before = isBefore(new Date(1987, 6, 10), new Date(1989, 1, 11))
// => true
exports.equal = isBefore(new Date(1989, 6, 10), new Date(1989, 6, 10))
// => false
exports.after = isBefore(new Date(1989, 6, 10), new Date(1987, 1, 11))
// => false
================================================
FILE: src/content/date-fns/00-generic/isBefore/notes.md
================================================
Is the first date before the second one?
================================================
FILE: src/content/date-fns/00-generic/isBefore/spec.js
================================================
const expected = {
before: true,
equal: false,
after: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isBefore', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isBefore/vanilla.js
================================================
const isBefore = (dateA, dateB) => dateA < dateB
exports.before = isBefore(new Date(1987, 6, 10), new Date(1989, 1, 11))
// => true
exports.equal = isBefore(new Date(1989, 6, 10), new Date(1989, 6, 10))
// => false
exports.after = isBefore(new Date(1989, 6, 10), new Date(1987, 1, 11))
// => false
================================================
FILE: src/content/date-fns/00-generic/isDate/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isDate
import { isDate } from 'date-fns'
// For a valid date:
exports.valid = isDate(new Date())
// => true
// For an invalid date:
exports.invalid = isDate(new Date(NaN))
// => true
// For some value:
exports.string = isDate('2014-02-31')
// => false
// For an object:
exports.object = isDate({})
// => false
================================================
FILE: src/content/date-fns/00-generic/isDate/notes.md
================================================
Is the given value a date?
================================================
FILE: src/content/date-fns/00-generic/isDate/spec.js
================================================
const expected = {
valid: true,
invalid: true,
string: false,
object: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isDate', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isDate/vanilla.js
================================================
const isDate = date => date instanceof Date
// For a valid date:
exports.valid = isDate(new Date())
// => true
// For an invalid date:
exports.invalid = isDate(new Date(NaN))
// => true
// For some value:
exports.string = isDate('2014-02-31')
// => false
// For an object:
exports.object = isDate({})
// => false
================================================
FILE: src/content/date-fns/00-generic/isEqual/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isEqual
import { isEqual } from 'date-fns'
// Are 2 July 2014 06:30:45.000 and 2 July 2014 06:30:45.500 equal?
exports.notEqual = isEqual(
new Date(2014, 6, 2, 6, 30, 45, 0),
new Date(2014, 6, 2, 6, 30, 45, 500)
)
// => false
exports.equal = isEqual(
new Date(2014, 6, 2, 6, 30, 45, 500),
new Date(2014, 6, 2, 6, 30, 45, 500)
)
// => true
================================================
FILE: src/content/date-fns/00-generic/isEqual/notes.md
================================================
Are the given dates equal?
================================================
FILE: src/content/date-fns/00-generic/isEqual/spec.js
================================================
const expected = {
equal: true,
notEqual: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isEqual', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isEqual/vanilla.js
================================================
const isEqual = (dateA, dateB) => dateA.getTime() === dateB.getTime()
// Are 2 July 2014 06:30:45.000 and 2 July 2014 06:30:45.500 equal?
exports.notEqual = isEqual(
new Date(2014, 6, 2, 6, 30, 45, 0),
new Date(2014, 6, 2, 6, 30, 45, 500)
)
// => false
exports.equal = isEqual(
new Date(2014, 6, 2, 6, 30, 45, 500),
new Date(2014, 6, 2, 6, 30, 45, 500)
)
// => true
================================================
FILE: src/content/date-fns/00-generic/isExists/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isExists
import { isExists } from 'date-fns'
// For the valid date:
exports.valid = isExists(2018, 0, 31)
// => true
// For the invalid date:
exports.invalid = isExists(2018, 1, 31)
// => false
================================================
FILE: src/content/date-fns/00-generic/isExists/notes.md
================================================
Is the given date exists?
================================================
FILE: src/content/date-fns/00-generic/isExists/spec.js
================================================
const expected = {
valid: true,
invalid: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isExists', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isExists/vanilla.js
================================================
const isExists = (y, m, d) => {
const date = new Date(y, m, d)
return (
date.getDate() === d && date.getMonth() === m && date.getFullYear() === y
)
}
// For the valid date:
exports.valid = isExists(2018, 0, 31)
// => true
// For the invalid date:
exports.invalid = isExists(2018, 1, 31)
// => false
================================================
FILE: src/content/date-fns/00-generic/isFuture/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isFuture
import { isFuture } from 'date-fns'
// If today is 25 September 2014, Is 31 December 2014 in the future?
exports.future = isFuture(new Date(2014, 11, 31))
// => true
// If today is 25 September 2014, Is 31 December 1980 in the future?
exports.past = isFuture(new Date(1980, 11, 31))
// => false
================================================
FILE: src/content/date-fns/00-generic/isFuture/notes.md
================================================
Is the given date in the future?
================================================
FILE: src/content/date-fns/00-generic/isFuture/spec.js
================================================
const expected = {
future: true,
past: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isFuture', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isFuture/vanilla.js
================================================
const isFuture = date => date > new Date()
// Is 31 December 2214 in the future?
exports.future = isFuture(new Date(2214, 11, 31))
// => true
// Is 31 December 1980 in the future?
exports.past = isFuture(new Date(1980, 11, 31))
// => false
================================================
FILE: src/content/date-fns/00-generic/isPast/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isPast
import { isPast } from 'date-fns'
// If today is 25 September 2014, Is 2 July 2014 in the past?
exports.past = isPast(new Date(2014, 6, 2))
// => true
// If today is 25 September 2014, Is 2 July 2015 in the past?
exports.future = isPast(new Date(2015, 6, 2))
// => false
================================================
FILE: src/content/date-fns/00-generic/isPast/notes.md
================================================
Is the given date in the past?
================================================
FILE: src/content/date-fns/00-generic/isPast/spec.js
================================================
const expected = {
past: true,
future: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isPast', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isPast/vanilla.js
================================================
const isPast = date => date < new Date()
// Is 2 July 2014 in the past?
exports.past = isPast(new Date(2014, 6, 2))
// => true
// Is 2 July 2214 in the past?
exports.future = isPast(new Date(2214, 6, 2))
// => false
================================================
FILE: src/content/date-fns/00-generic/isValid/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isValid
import { isValid } from 'date-fns'
// For the valid date:
exports.valid = isValid(new Date(2014, 1, 31))
// => true
// For the value, convertable into a date:
exports.convertible = isValid(1393804800000)
// => true
// For the invalid date:
exports.invalid = isValid(new Date(''))
// => false
================================================
FILE: src/content/date-fns/00-generic/isValid/notes.md
================================================
Is the given date valid?
================================================
FILE: src/content/date-fns/00-generic/isValid/spec.js
================================================
const expected = {
valid: true,
convertible: true,
invalid: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isValid', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/isValid/vanilla.js
================================================
/* eslint-disable no-restricted-globals */
const isValid = date =>
!isNaN((date instanceof Date ? date : new Date(date)).getTime())
// For the valid date:
exports.valid = isValid(new Date(2014, 1, 31))
// => true
// For the value, convertable into a date:
exports.convertible = isValid(1393804800000)
// => true
// For the invalid date:
exports.invalid = isValid(new Date(''))
// => false
================================================
FILE: src/content/date-fns/00-generic/max/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/max
import { max } from 'date-fns'
// Which of these dates is the latest?
module.exports = max([
new Date(1989, 6, 10),
new Date(1987, 1, 11),
new Date(1995, 6, 2),
new Date(1990, 0, 1),
])
// => Sun Jul 02 1995 00:00:00
================================================
FILE: src/content/date-fns/00-generic/max/notes.md
================================================
Return the latest of the given dates.
================================================
FILE: src/content/date-fns/00-generic/max/spec.js
================================================
const expected = new Date(1995, 6, 2)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('max', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/max/vanilla.js
================================================
const max = dates => new Date(Math.max(...dates.map(date => date.getTime())))
// Which of these dates is the latest?
module.exports = max([
new Date(1989, 6, 10),
new Date(1987, 1, 11),
new Date(1995, 6, 2),
new Date(1990, 0, 1),
])
// => Sun Jul 02 1995 00:00:00
================================================
FILE: src/content/date-fns/00-generic/min/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/min
import { min } from 'date-fns'
// Which of these dates is the earliest?
module.exports = min([
new Date(1989, 6, 10),
new Date(1987, 1, 11),
new Date(1995, 6, 2),
new Date(1990, 0, 1),
])
// => Wed Feb 11 1987 00:00:00
================================================
FILE: src/content/date-fns/00-generic/min/notes.md
================================================
Return the earliest of the given dates.
================================================
FILE: src/content/date-fns/00-generic/min/spec.js
================================================
const expected = new Date(1987, 1, 11)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('min', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/00-generic/min/vanilla.js
================================================
const min = dates => new Date(Math.min(...dates.map(date => date.getTime())))
// Which of these dates is the earliest?
module.exports = min([
new Date(1989, 6, 10),
new Date(1987, 1, 11),
new Date(1995, 6, 2),
new Date(1990, 0, 1),
])
// => Wed Feb 11 1987 00:00:00
================================================
FILE: src/content/date-fns/01-interval/areIntervalsOverlapping/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/areIntervalsOverlapping
import { areIntervalsOverlapping } from 'date-fns'
exports.overlapping = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 17), end: new Date(2014, 0, 21) }
)
//=> true
exports.nonOverlapping = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 21), end: new Date(2014, 0, 22) }
)
//=> false
exports.adjacent = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 20), end: new Date(2014, 0, 24) }
)
//=> false
exports.inclusive = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 20), end: new Date(2014, 0, 24) },
{ inclusive: true }
)
//=> true
================================================
FILE: src/content/date-fns/01-interval/areIntervalsOverlapping/notes.md
================================================
Is the given time interval overlapping with another time interval? Adjacent intervals do not count as overlapping unless inclusive is set to true.
Resources: [Date#getTime](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTime)
================================================
FILE: src/content/date-fns/01-interval/areIntervalsOverlapping/spec.js
================================================
const expected = {
'adjacent': false,
'inclusive': true,
'nonOverlapping': false,
'overlapping': true,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('areIntervalsOverlapping', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/01-interval/areIntervalsOverlapping/vanilla.js
================================================
const areIntervalsOverlapping = (
{ start: rxStart, end: rxEnd },
{ start: ryStart, end: ryEnd },
{ inclusive } = {}
) =>
!!(
(ryStart > rxStart && ryStart < rxEnd) ||
(ryEnd > rxStart && ryStart < rxEnd) ||
(inclusive && rxEnd.getTime() === ryStart.getTime()) ||
(inclusive && ryEnd.getTime() === rxStart.getTime())
)
exports.overlapping = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 17), end: new Date(2014, 0, 21) }
)
//=> true
exports.nonOverlapping = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 21), end: new Date(2014, 0, 22) }
)
//=> false
exports.adjacent = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 20), end: new Date(2014, 0, 30) }
)
//=> false
exports.inclusive = areIntervalsOverlapping(
{ start: new Date(2014, 0, 10), end: new Date(2014, 0, 20) },
{ start: new Date(2014, 0, 20), end: new Date(2014, 0, 24) },
{ inclusive: true }
)
//=> true
================================================
FILE: src/content/date-fns/01-interval/eachDayOfInterval/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/eachDayOfInterval
import { eachDayOfInterval } from 'date-fns'
exports.default = eachDayOfInterval({
start: new Date(2014, 9, 6),
end: new Date(2014, 9, 10),
})
//=> [
// Mon Oct 06 2014 00:00:00,
// Tue Oct 07 2014 00:00:00,
// Wed Oct 08 2014 00:00:00,
// Thu Oct 09 2014 00:00:00,
// Fri Oct 10 2014 00:00:00
// ]
exports.stepped = eachDayOfInterval(
{
start: new Date(2014, 9, 6),
end: new Date(2014, 9, 10),
},
{ step: 3 }
)
//=> [
// Wed Oct 06 2014 00:00:00,
// Mon Oct 09 2014 00:00:00,
// ]
================================================
FILE: src/content/date-fns/01-interval/eachDayOfInterval/notes.md
================================================
================================================
FILE: src/content/date-fns/01-interval/eachDayOfInterval/spec.js
================================================
const expected = {
'default': [
new Date(2014, 9, 6).toString(),
new Date(2014, 9, 7).toString(),
new Date(2014, 9, 8).toString(),
new Date(2014, 9, 9).toString(),
new Date(2014, 9, 10).toString(),
],
'stepped': [new Date(2014, 9, 6).toString(), new Date(2014, 9, 9).toString()],
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('eachDayOfInterval', () => {
expect({
default: datefns.default.map(a => a.toString()),
stepped: datefns.stepped.map(a => a.toString()),
}).toEqual(expected)
expect({
default: plain.default.map(a => a.toString()),
stepped: plain.stepped.map(a => a.toString()),
}).toEqual(expected)
})
================================================
FILE: src/content/date-fns/01-interval/eachDayOfInterval/vanilla.js
================================================
const eachDayOfInterval = ({ start, end }, { step } = { step: 1 }) => {
const retArr = []
start.setHours(0, 0, 0, 0)
end.setHours(0, 0, 0, 0)
do {
retArr.push(new Date(start.getTime()))
start.setDate(start.getDate() + step)
} while (start.getTime() <= end.getTime())
return retArr
}
exports.default = eachDayOfInterval({
start: new Date(2014, 9, 6),
end: new Date(2014, 9, 10),
})
//=> [
// Mon Oct 06 2014 00:00:00,
// Tue Oct 07 2014 00:00:00,
// Wed Oct 08 2014 00:00:00,
// Thu Oct 09 2014 00:00:00,
// Fri Oct 10 2014 00:00:00
// ]
exports.stepped = eachDayOfInterval(
{
start: new Date(2014, 9, 6),
end: new Date(2014, 9, 10),
},
{ step: 3 }
)
//=> [
// Wed Oct 06 2014 00:00:00,
// Mon Oct 08 2014 00:00:00,
// ]
================================================
FILE: src/content/date-fns/01-interval/isWithinInterval/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isWithinInterval
import { isWithinInterval } from 'date-fns'
exports.in = isWithinInterval(new Date(2014, 0, 3), {
start: new Date(2014, 0, 1),
end: new Date(2014, 0, 7),
})
//=> true
exports.out = isWithinInterval(new Date(2014, 0, 10), {
start: new Date(2014, 0, 1),
end: new Date(2014, 0, 7),
})
//=> false
const date = new Date()
exports.start = isWithinInterval(date, {
start: date,
end: new Date(2500, 0, 1),
})
// => true
exports.end = isWithinInterval(date, {
start: new Date(2020, 0, 1),
end: date,
})
// => true
================================================
FILE: src/content/date-fns/01-interval/isWithinInterval/notes.md
================================================
================================================
FILE: src/content/date-fns/01-interval/isWithinInterval/spec.js
================================================
const expected = { 'in': true, 'out': false, 'start': true, 'end': true }
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isWithinInterval', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/01-interval/isWithinInterval/vanilla.js
================================================
const isWithinInterval = (date, { start, end }) =>
date.getTime() >= start.getTime() && date.getTime() <= end.getTime()
exports.in = isWithinInterval(new Date(2014, 0, 3), {
start: new Date(2014, 0, 1),
end: new Date(2014, 0, 7),
})
//=> true
exports.out = isWithinInterval(new Date(2014, 0, 10), {
start: new Date(2014, 0, 1),
end: new Date(2014, 0, 7),
})
//=> false
// new Date is mocked as
// new Date(2014, 8, 25, 18, 30, 15, 500)
const date = new Date()
exports.start = isWithinInterval(date, {
start: date,
end: new Date(2020, 0, 1),
})
// => true
exports.end = isWithinInterval(date, {
start: new Date(2000, 0, 1),
end: date,
})
// => true
================================================
FILE: src/content/date-fns/01-timestamp/fromUnixTime/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/fromUnixTime
import { fromUnixTime } from 'date-fns'
// Create the date 29 February 2012 11:45:05:
module.exports = fromUnixTime(1330515905)
// => Wed Feb 29 2012 11:45:05
================================================
FILE: src/content/date-fns/01-timestamp/fromUnixTime/notes.md
================================================
Create a date from a Unix timestamp.
================================================
FILE: src/content/date-fns/01-timestamp/fromUnixTime/spec.js
================================================
const expected = new Date(Date.UTC(2012, 1, 29, 11, 45, 5))
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('fromUnixTime', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/01-timestamp/fromUnixTime/vanilla.js
================================================
const fromUnixTime = unixTime => new Date(unixTime * 1000)
// Create the date 29 February 2012 11:45:05:
module.exports = fromUnixTime(1330515905)
// => Wed Feb 29 2012 11:45:05
================================================
FILE: src/content/date-fns/01-timestamp/getTime/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getTime
import { getTime } from 'date-fns'
// Get the timestamp of 29 February 2012 11:45:05.123:
module.exports = getTime(new Date(Date.UTC(2012, 1, 29, 11, 45, 5, 123)))
// => 1330515905123
================================================
FILE: src/content/date-fns/01-timestamp/getTime/notes.md
================================================
Get the milliseconds timestamp of the given date.
================================================
FILE: src/content/date-fns/01-timestamp/getTime/spec.js
================================================
const expected = 1330515905123
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getTime', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/01-timestamp/getTime/vanilla.js
================================================
const getTime = date => date.getTime()
// Get the timestamp of 29 February 2012 11:45:05.123:
module.exports = getTime(new Date(Date.UTC(2012, 1, 29, 11, 45, 5, 123)))
// => 1330515905123
================================================
FILE: src/content/date-fns/01-timestamp/getUnixTime/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getUnixTime
import { getUnixTime } from 'date-fns'
// Get the timestamp of 29 February 2012 11:45:05 CET:
module.exports = getUnixTime(new Date(Date.UTC(2012, 1, 29, 11, 45, 5)))
// => 1330515905
================================================
FILE: src/content/date-fns/01-timestamp/getUnixTime/notes.md
================================================
Get the seconds timestamp of the given date.
================================================
FILE: src/content/date-fns/01-timestamp/getUnixTime/spec.js
================================================
const expected = 1330515905
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getUnixTime', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/01-timestamp/getUnixTime/vanilla.js
================================================
const getUnixTime = date => Math.trunc(date / 1000)
// Get the timestamp of 29 February 2012 11:45:05 CET:
module.exports = getUnixTime(new Date(Date.UTC(2012, 1, 29, 11, 45, 5)))
// => 1330512305
================================================
FILE: src/content/date-fns/02-millisecond/addMilliseconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addMilliseconds
import { addMilliseconds } from 'date-fns'
// Add 750 milliseconds to 10 July 2014 12:45:30.000:
module.exports = addMilliseconds(new Date(2014, 6, 10, 12, 45, 30, 0), 750)
// => Thu Jul 10 2014 12:45:30.750
================================================
FILE: src/content/date-fns/02-millisecond/addMilliseconds/notes.md
================================================
Add the specified number of milliseconds to the given date.
================================================
FILE: src/content/date-fns/02-millisecond/addMilliseconds/spec.js
================================================
const expected = new Date(2014, 6, 10, 12, 45, 30, 750)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addMilliseconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-millisecond/addMilliseconds/vanilla.js
================================================
const addMilliseconds = (date, ms) => {
date.setMilliseconds(date.getMilliseconds() + ms)
return date
}
// Add 750 milliseconds to 10 July 2014 12:45:30.000:
module.exports = addMilliseconds(new Date(2014, 6, 10, 12, 45, 30, 0), 750)
// => Thu Jul 10 2014 12:45:30.750
================================================
FILE: src/content/date-fns/02-millisecond/differenceInMilliseconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInMilliseconds
import { differenceInMilliseconds } from 'date-fns'
// How many milliseconds are between
// 2 July 2014 12:30:20.600 and 2 July 2014 12:30:21.700?
module.exports = differenceInMilliseconds(
new Date(2014, 6, 2, 12, 30, 21, 700),
new Date(2014, 6, 2, 12, 30, 20, 600)
)
// => 1100
================================================
FILE: src/content/date-fns/02-millisecond/differenceInMilliseconds/notes.md
================================================
Get the number of milliseconds between the given dates.
================================================
FILE: src/content/date-fns/02-millisecond/differenceInMilliseconds/spec.js
================================================
const expected = 1100
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInMilliseconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-millisecond/differenceInMilliseconds/vanilla.js
================================================
const differenceInMilliseconds = (dateA, dateB) => dateA - dateB
// How many milliseconds are between
// 2 July 2014 12:30:20.600 and 2 July 2014 12:30:21.700?
module.exports = differenceInMilliseconds(
new Date(2014, 6, 2, 12, 30, 21, 700),
new Date(2014, 6, 2, 12, 30, 20, 600)
)
// => 1100
================================================
FILE: src/content/date-fns/02-millisecond/getMilliseconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getMilliseconds
import { getMilliseconds } from 'date-fns'
// Get the milliseconds of 29 February 2012 11:45:05.123:
module.exports = getMilliseconds(new Date(2012, 1, 29, 11, 45, 5, 123))
// => 123
================================================
FILE: src/content/date-fns/02-millisecond/getMilliseconds/notes.md
================================================
Get the milliseconds of the given date.
================================================
FILE: src/content/date-fns/02-millisecond/getMilliseconds/spec.js
================================================
const expected = 123
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getMilliseconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-millisecond/getMilliseconds/vanilla.js
================================================
const getMilliseconds = date => date.getMilliseconds()
// Get the milliseconds of 29 February 2012 11:45:05.123:
module.exports = getMilliseconds(new Date(2012, 1, 29, 11, 45, 5, 123))
// => 123
================================================
FILE: src/content/date-fns/02-millisecond/setMilliseconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setMilliseconds
import { setMilliseconds } from 'date-fns'
// Set 300 milliseconds to 1 September 2014 11:30:40.500:
module.exports = setMilliseconds(new Date(2014, 8, 1, 11, 30, 40, 500), 300)
// => Mon Sep 01 2014 11:30:40.300
================================================
FILE: src/content/date-fns/02-millisecond/setMilliseconds/notes.md
================================================
Set the milliseconds to the given date.
================================================
FILE: src/content/date-fns/02-millisecond/setMilliseconds/spec.js
================================================
const expected = new Date(2014, 8, 1, 11, 30, 40, 300)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setMilliseconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-millisecond/setMilliseconds/vanilla.js
================================================
const setMilliseconds = (date, ms) => {
date.setMilliseconds(ms)
return date
}
// Set 300 milliseconds to 1 September 2014 11:30:40.500:
module.exports = setMilliseconds(new Date(2014, 8, 1, 11, 30, 40, 500), 300)
// => Mon Sep 01 2014 11:30:40.300
================================================
FILE: src/content/date-fns/02-millisecond/subMilliseconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subMilliseconds
import { subMilliseconds } from 'date-fns'
// Subtract 750 milliseconds from 10 July 2014 12:45:30.000:
module.exports = subMilliseconds(new Date(2014, 6, 10, 12, 45, 30, 0), 750)
// => Thu Jul 10 2014 12:45:29.250
================================================
FILE: src/content/date-fns/02-millisecond/subMilliseconds/notes.md
================================================
Subtract the specified number of milliseconds from the given date.
================================================
FILE: src/content/date-fns/02-millisecond/subMilliseconds/spec.js
================================================
const expected = new Date(2014, 6, 10, 12, 45, 29, 250)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subMilliseconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-millisecond/subMilliseconds/vanilla.js
================================================
const subMilliseconds = (date, ms) => {
date.setMilliseconds(date.getMilliseconds() - ms)
return date
}
// Subtract 750 milliseconds from 10 July 2014 12:45:30.000:
module.exports = subMilliseconds(new Date(2014, 6, 10, 12, 45, 30, 0), 750)
// => Thu Jul 10 2014 12:45:29.250
================================================
FILE: src/content/date-fns/02-second/addSeconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addSeconds
import { addSeconds } from 'date-fns'
// Add 30 seconds to 10 July 2014 12:45:00:
module.exports = addSeconds(new Date(2014, 6, 10, 12, 45, 0), 30)
// => Thu Jul 10 2014 12:45:30
================================================
FILE: src/content/date-fns/02-second/addSeconds/notes.md
================================================
Add the specified number of seconds to the given date.
================================================
FILE: src/content/date-fns/02-second/addSeconds/spec.js
================================================
const expected = new Date(2014, 6, 10, 12, 45, 30)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addSeconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/addSeconds/vanilla.js
================================================
const addSeconds = (date, s) => {
date.setSeconds(date.getSeconds() + s)
return date
}
// Add 30 seconds to 10 July 2014 12:45:00:
module.exports = addSeconds(new Date(2014, 6, 10, 12, 45, 0), 30)
// => Thu Jul 10 2014 12:45:30
================================================
FILE: src/content/date-fns/02-second/differenceInSeconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInSeconds
import { differenceInSeconds } from 'date-fns'
// How many seconds are between
// 2 July 2014 12:30:07.999 and 2 July 2014 12:30:20.000?
module.exports = differenceInSeconds(
new Date(2014, 6, 2, 12, 30, 20, 0),
new Date(2014, 6, 2, 12, 30, 7, 999)
)
// => 12
================================================
FILE: src/content/date-fns/02-second/differenceInSeconds/notes.md
================================================
Get the number of seconds between the given dates.
================================================
FILE: src/content/date-fns/02-second/differenceInSeconds/spec.js
================================================
const expected = 12
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInSeconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/differenceInSeconds/vanilla.js
================================================
const differenceInSeconds = (dateA, dateB) => Math.trunc((dateA - dateB) / 1000)
// How many seconds are between
// 2 July 2014 12:30:07.999 and 2 July 2014 12:30:20.000?
module.exports = differenceInSeconds(
new Date(2014, 6, 2, 12, 30, 20, 0),
new Date(2014, 6, 2, 12, 30, 7, 999)
)
// => 12
================================================
FILE: src/content/date-fns/02-second/endOfSecond/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/endOfSecond
import { endOfSecond } from 'date-fns'
// The end of a second for 1 December 2014 22:15:45.400:
module.exports = endOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:45.999
================================================
FILE: src/content/date-fns/02-second/endOfSecond/notes.md
================================================
Return the end of a second for the given date.
================================================
FILE: src/content/date-fns/02-second/endOfSecond/spec.js
================================================
const expected = new Date(2014, 11, 1, 22, 15, 45, 999)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('endOfSecond', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/endOfSecond/vanilla.js
================================================
const endOfSecond = date => new Date(Math.ceil(date / 1000) * 1000 - 1)
// The end of a second for 1 December 2014 22:15:45.400:
module.exports = endOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:45.999
================================================
FILE: src/content/date-fns/02-second/getSeconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getSeconds
import { getSeconds } from 'date-fns'
// Get the seconds of 29 February 2012 11:45:05.123:
module.exports = getSeconds(new Date(2012, 1, 29, 11, 45, 5, 123))
// => 5
================================================
FILE: src/content/date-fns/02-second/getSeconds/notes.md
================================================
Get the seconds of the given date.
================================================
FILE: src/content/date-fns/02-second/getSeconds/spec.js
================================================
const expected = 5
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getSeconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/getSeconds/vanilla.js
================================================
const getSeconds = date => date.getSeconds()
// Get the seconds of 29 February 2012 11:45:05.123:
module.exports = getSeconds(new Date(2012, 1, 29, 11, 45, 5, 123))
// => 5
================================================
FILE: src/content/date-fns/02-second/isSameSecond/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSameSecond
import { isSameSecond } from 'date-fns'
// Are 4 September 2014 06:30:15.000 and 4 September 2014 06:30.15.500
// in the same second?
module.exports = isSameSecond(
new Date(2014, 8, 4, 6, 30, 15),
new Date(2014, 8, 4, 6, 30, 15, 500)
)
// => true
================================================
FILE: src/content/date-fns/02-second/isSameSecond/notes.md
================================================
Are the given dates in the same second?
================================================
FILE: src/content/date-fns/02-second/isSameSecond/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSameSecond', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/isSameSecond/vanilla.js
================================================
const isSameSecond = (dateA, dateB) =>
Math.abs(dateA - dateB) < 1000 && dateA.getSeconds() === dateB.getSeconds()
// Are 4 September 2014 06:30:15.000 and 4 September 2014 06:30.15.500
// in the same second?
module.exports = isSameSecond(
new Date(2014, 8, 4, 6, 30, 15, 0),
new Date(2014, 8, 4, 6, 30, 15, 500)
)
// => true
================================================
FILE: src/content/date-fns/02-second/isThisSecond/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isThisSecond
import { isThisSecond } from 'date-fns'
// If now is 25 September 2014 18:30:15.500,
// is 25 September 2014 18:30:15.000 in this second?
module.exports = isThisSecond(new Date(2014, 8, 25, 18, 30, 15))
// => true
================================================
FILE: src/content/date-fns/02-second/isThisSecond/notes.md
================================================
Is the given date in the same second as the current date?
================================================
FILE: src/content/date-fns/02-second/isThisSecond/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isThisSecond', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/isThisSecond/vanilla.js
================================================
const isThisSecond = (dateA, dateB = new Date()) =>
Math.abs(dateA - dateB) < 1000 && dateA.getSeconds() === dateB.getSeconds()
// If now is 25 September 2014 18:30:15.500,
// is 25 September 2014 18:30:15.000 in this second?
module.exports = isThisSecond(new Date(2014, 8, 25, 18, 30, 15))
// => true
================================================
FILE: src/content/date-fns/02-second/setSeconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setSeconds
import { setSeconds } from 'date-fns'
// Set 45 seconds to 1 September 2014 11:30:40:
module.exports = setSeconds(new Date(2014, 8, 1, 11, 30, 40), 45)
// => Mon Sep 01 2014 11:30:45
================================================
FILE: src/content/date-fns/02-second/setSeconds/notes.md
================================================
Set the seconds to the given date.
================================================
FILE: src/content/date-fns/02-second/setSeconds/spec.js
================================================
const expected = new Date(2014, 8, 1, 11, 30, 45)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setSeconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/setSeconds/vanilla.js
================================================
const setSeconds = (date, s) => {
date.setSeconds(s)
return date
}
// Set 45 seconds to 1 September 2014 11:30:40:
module.exports = setSeconds(new Date(2014, 8, 1, 11, 30, 40), 45)
// => Mon Sep 01 2014 11:30:45
================================================
FILE: src/content/date-fns/02-second/startOfSecond/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/startOfSecond
import { startOfSecond } from 'date-fns'
// The start of a second for 1 December 2014 22:15:45.400:
module.exports = startOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:45.000
================================================
FILE: src/content/date-fns/02-second/startOfSecond/notes.md
================================================
Return the start of a second for the given date.
================================================
FILE: src/content/date-fns/02-second/startOfSecond/spec.js
================================================
const expected = new Date(2014, 11, 1, 22, 15, 45)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('startOfSecond', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/startOfSecond/vanilla.js
================================================
const startOfSecond = date => new Date(Math.floor(date / 1000) * 1000)
// The start of a second for 1 December 2014 22:15:45.400:
module.exports = startOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:45.000
================================================
FILE: src/content/date-fns/02-second/subSeconds/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subSeconds
import { subSeconds } from 'date-fns'
// Subtract 30 seconds from 10 July 2014 12:45:00:
module.exports = subSeconds(new Date(2014, 6, 10, 12, 45, 0), 30)
// => Thu Jul 10 2014 12:44:30
================================================
FILE: src/content/date-fns/02-second/subSeconds/notes.md
================================================
Subtract the specified number of seconds from the given date.
================================================
FILE: src/content/date-fns/02-second/subSeconds/spec.js
================================================
const expected = new Date(2014, 6, 10, 12, 44, 30)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subSeconds', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/02-second/subSeconds/vanilla.js
================================================
const subSeconds = (date, s) => {
date.setSeconds(date.getSeconds() - s)
return date
}
// Subtract 30 seconds from 10 July 2014 12:45:00:
module.exports = subSeconds(new Date(2014, 6, 10, 12, 45, 0), 30)
// => Thu Jul 10 2014 12:44:30
================================================
FILE: src/content/date-fns/03-minute/addMinutes/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addMinutes
import { addMinutes } from 'date-fns'
// Add 30 minutes to 10 July 2014 12:00:00:
module.exports = addMinutes(new Date(2014, 6, 10, 12, 0), 30)
// => Thu Jul 10 2014 12:30:00
================================================
FILE: src/content/date-fns/03-minute/addMinutes/notes.md
================================================
Add the specified number of minutes to the given date.
================================================
FILE: src/content/date-fns/03-minute/addMinutes/spec.js
================================================
const expected = new Date(2014, 6, 10, 12, 30)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addMinutes', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/addMinutes/vanilla.js
================================================
const addMinutes = (date, m) => {
date.setMinutes(date.getMinutes() + m)
return date
}
// Add 30 minutes to 10 July 2014 12:00:00:
module.exports = addMinutes(new Date(2014, 6, 10, 12, 0), 30)
// => Thu Jul 10 2014 12:30:00
================================================
FILE: src/content/date-fns/03-minute/differenceInMinutes/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInMinutes
import { differenceInMinutes } from 'date-fns'
// How many minutes are between 2 July 2014 12:07:59 and 2 July 2014 12:20:00?
exports.positive = differenceInMinutes(
new Date(2014, 6, 2, 12, 20, 0),
new Date(2014, 6, 2, 12, 7, 59)
)
// => 12
// How many minutes are from 10:01:59 to 10:00:00
exports.negative = differenceInMinutes(
new Date(2000, 0, 1, 10, 0, 0),
new Date(2000, 0, 1, 10, 1, 59)
)
// => -1
================================================
FILE: src/content/date-fns/03-minute/differenceInMinutes/notes.md
================================================
Get the number of minutes between the given dates.
================================================
FILE: src/content/date-fns/03-minute/differenceInMinutes/spec.js
================================================
const expected = {
positive: 12,
negative: -1,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInMinutes', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/differenceInMinutes/vanilla.js
================================================
const differenceInMinutes = (dateA, dateB) =>
Math.trunc((dateA - dateB) / (1000 * 60))
// How many minutes are between 2 July 2014 12:07:59 and 2 July 2014 12:20:00?
exports.positive = differenceInMinutes(
new Date(2014, 6, 2, 12, 20, 0),
new Date(2014, 6, 2, 12, 7, 59)
)
// => 12
// How many minutes are from 10:01:59 to 10:00:00
exports.negative = differenceInMinutes(
new Date(2000, 0, 1, 10, 0, 0),
new Date(2000, 0, 1, 10, 1, 59)
)
// => -1
================================================
FILE: src/content/date-fns/03-minute/endOfMinute/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/endOfMinute
import { endOfMinute } from 'date-fns'
// The end of a minute for 1 December 2014 22:15:45.400:
module.exports = endOfMinute(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:59.999
================================================
FILE: src/content/date-fns/03-minute/endOfMinute/notes.md
================================================
Return the end of a minute for the given date.
================================================
FILE: src/content/date-fns/03-minute/endOfMinute/spec.js
================================================
const expected = new Date(2014, 11, 1, 22, 15, 59, 999)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('endOfMinute', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/endOfMinute/vanilla.js
================================================
const endOfMinute = date =>
new Date(Math.ceil(date / (1000 * 60)) * 1000 * 60 - 1)
// The end of a minute for 1 December 2014 22:15:45.400:
module.exports = endOfMinute(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:59.999
================================================
FILE: src/content/date-fns/03-minute/getMinutes/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getMinutes
import { getMinutes } from 'date-fns'
// Get the minutes of 29 February 2012 11:45:05:
module.exports = getMinutes(new Date(2012, 1, 29, 11, 45, 5))
// => 45
================================================
FILE: src/content/date-fns/03-minute/getMinutes/notes.md
================================================
Get the minutes of the given date.
================================================
FILE: src/content/date-fns/03-minute/getMinutes/spec.js
================================================
const expected = 45
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getMinutes', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/getMinutes/vanilla.js
================================================
const getMinutes = date => date.getMinutes()
// Get the minutes of 29 February 2012 11:45:05:
module.exports = getMinutes(new Date(2012, 1, 29, 11, 45, 5))
// => 45
================================================
FILE: src/content/date-fns/03-minute/isSameMinute/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSameMinute
import { isSameMinute } from 'date-fns'
// Are 4 September 2014 06:30:00 and 4 September 2014 06:30:15
// in the same minute?
module.exports = isSameMinute(
new Date(2014, 8, 4, 6, 30),
new Date(2014, 8, 4, 6, 30, 15)
)
// => true
================================================
FILE: src/content/date-fns/03-minute/isSameMinute/notes.md
================================================
Are the given dates in the same minute?
================================================
FILE: src/content/date-fns/03-minute/isSameMinute/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSameMinute', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/isSameMinute/vanilla.js
================================================
const isSameMinute = (dateA, dateB) =>
Math.abs(dateA - dateB) < 1000 * 60 &&
dateA.getMinutes() === dateB.getMinutes()
// Are 4 September 2014 06:30:00 and 4 September 2014 06:30:15
// in the same minute?
module.exports = isSameMinute(
new Date(2014, 8, 4, 6, 30),
new Date(2014, 8, 4, 6, 30, 15)
)
// => true
================================================
FILE: src/content/date-fns/03-minute/isThisMinute/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isThisMinute
import { isThisMinute } from 'date-fns'
// If now is 25 September 2014 18:30:15.500,
// is 25 September 2014 18:30:00 in this minute?
module.exports = isThisMinute(new Date(2014, 8, 25, 18, 30))
// => true
================================================
FILE: src/content/date-fns/03-minute/isThisMinute/notes.md
================================================
Is the given date in the same minute as the current date?
================================================
FILE: src/content/date-fns/03-minute/isThisMinute/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isThisMinute', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/isThisMinute/vanilla.js
================================================
const isThisMinute = (dateA, dateB = new Date()) =>
Math.abs(dateA - dateB) < 1000 * 60 &&
dateA.getMinutes() === dateB.getMinutes()
// If now is 25 September 2014 18:30:15.500,
// is 25 September 2014 18:30:00 in this minute?
module.exports = isThisMinute(new Date(2014, 8, 25, 18, 30))
// => true
================================================
FILE: src/content/date-fns/03-minute/roundToNearestMinutes/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/roundToNearestMinutes
import { roundToNearestMinutes } from 'date-fns'
// Round 10 July 2014 12:12:34 to nearest minute:
module.exports = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34))
// => Thu Jul 10 2014 12:13:00
================================================
FILE: src/content/date-fns/03-minute/roundToNearestMinutes/notes.md
================================================
Rounds the given date to the nearest minute
================================================
FILE: src/content/date-fns/03-minute/roundToNearestMinutes/spec.js
================================================
const expected = new Date(2014, 6, 10, 12, 13)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('roundToNearestMinutes', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/roundToNearestMinutes/vanilla.js
================================================
const roundToNearestMinutes = date =>
new Date(Math.round(date / (1000 * 60)) * 1000 * 60)
// Round 10 July 2014 12:12:34 to nearest minute:
module.exports = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34))
// => Thu Jul 10 2014 12:13:00
================================================
FILE: src/content/date-fns/03-minute/setMinutes/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setMinutes
import { setMinutes } from 'date-fns'
// Set 45 minutes to 1 September 2014 11:30:40:
module.exports = setMinutes(new Date(2014, 8, 1, 11, 30, 40), 45)
// => Mon Sep 01 2014 11:45:40
================================================
FILE: src/content/date-fns/03-minute/setMinutes/notes.md
================================================
Set the minutes to the given date.
================================================
FILE: src/content/date-fns/03-minute/setMinutes/spec.js
================================================
const expected = new Date(2014, 8, 1, 11, 45, 40)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setMinutes', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/setMinutes/vanilla.js
================================================
const setMinutes = (date, m) => {
date.setMinutes(m)
return date
}
// Set 45 minutes to 1 September 2014 11:30:40:
module.exports = setMinutes(new Date(2014, 8, 1, 11, 30, 40), 45)
// => Mon Sep 01 2014 11:45:40
================================================
FILE: src/content/date-fns/03-minute/startOfMinute/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/startOfMinute
import { startOfMinute } from 'date-fns'
// The start of a minute for 1 December 2014 22:15:45.400:
module.exports = startOfMinute(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:00
================================================
FILE: src/content/date-fns/03-minute/startOfMinute/notes.md
================================================
Return the start of a minute for the given date.
================================================
FILE: src/content/date-fns/03-minute/startOfMinute/spec.js
================================================
const expected = new Date(2014, 11, 1, 22, 15)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('startOfMinute', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/startOfMinute/vanilla.js
================================================
const startOfMinute = date =>
new Date(Math.floor(date / (1000 * 60)) * 1000 * 60)
// The start of a minute for 1 December 2014 22:15:45.400:
module.exports = startOfMinute(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:00
================================================
FILE: src/content/date-fns/03-minute/subMinutes/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subMinutes
import { subMinutes } from 'date-fns'
// Subtract 30 minutes from 10 July 2014 12:00:00:
module.exports = subMinutes(new Date(2014, 6, 10, 12, 0), 30)
// => Thu Jul 10 2014 11:30:00
================================================
FILE: src/content/date-fns/03-minute/subMinutes/notes.md
================================================
Subtract the specified number of minutes from the given date.
================================================
FILE: src/content/date-fns/03-minute/subMinutes/spec.js
================================================
const expected = new Date(2014, 6, 10, 11, 30)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subMinutes', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/03-minute/subMinutes/vanilla.js
================================================
const subMinutes = (date, m) => {
date.setMinutes(date.getMinutes() - m)
return date
}
// Subtract 30 minutes from 10 July 2014 12:00:00:
module.exports = subMinutes(new Date(2014, 6, 10, 12, 0), 30)
// => Thu Jul 10 2014 11:30:00
================================================
FILE: src/content/date-fns/04-hour/addHours/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addHours
import { addHours } from 'date-fns'
// Add 2 hours to 10 July 2014 23:00:00:
module.exports = addHours(new Date(2014, 6, 10, 23, 0), 2)
// => Fri Jul 11 2014 01:00:00
================================================
FILE: src/content/date-fns/04-hour/addHours/notes.md
================================================
Add the specified number of hours to the given date.
================================================
FILE: src/content/date-fns/04-hour/addHours/spec.js
================================================
const expected = new Date(2014, 6, 11, 1, 0)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addHours', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/addHours/vanilla.js
================================================
const addHours = (date, h) => {
date.setHours(date.getHours() + h)
return date
}
// Add 2 hours to 10 July 2014 23:00:00:
module.exports = addHours(new Date(2014, 6, 10, 23, 0), 2)
// => Fri Jul 11 2014 01:00:00
================================================
FILE: src/content/date-fns/04-hour/differenceInHours/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInHours
import { differenceInHours } from 'date-fns'
// How many hours are between 2 July 2014 06:50:00 and 2 July 2014 19:00:00?
module.exports = differenceInHours(
new Date(2014, 6, 2, 19, 0),
new Date(2014, 6, 2, 6, 50)
)
// => 12
================================================
FILE: src/content/date-fns/04-hour/differenceInHours/notes.md
================================================
Get the number of hours between the given dates.
================================================
FILE: src/content/date-fns/04-hour/differenceInHours/spec.js
================================================
const expected = 12
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInHours', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/differenceInHours/vanilla.js
================================================
const HOUR_IN_MS = 1000 * 60 * 60
const differenceInHours = (dateA, dateB) =>
Math.trunc((dateA - dateB) / HOUR_IN_MS)
// How many hours are between 2 July 2014 06:50:00 and 2 July 2014 19:00:00?
module.exports = differenceInHours(
new Date(2014, 6, 2, 19, 0),
new Date(2014, 6, 2, 6, 50)
)
// => 12
================================================
FILE: src/content/date-fns/04-hour/endOfHour/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/endOfHour
import { endOfHour } from 'date-fns'
// The end of an hour for 2 September 2014 11:55:00:
module.exports = endOfHour(new Date(2014, 8, 2, 11, 55))
// => Tue Sep 02 2014 11:59:59.999
================================================
FILE: src/content/date-fns/04-hour/endOfHour/notes.md
================================================
Return the end of an hour for the given date.
================================================
FILE: src/content/date-fns/04-hour/endOfHour/spec.js
================================================
const expected = new Date(2014, 8, 2, 11, 59, 59, 999)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('endOfHour', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/endOfHour/vanilla.js
================================================
const HOUR_IN_MS = 1000 * 60 * 60
const endOfHour = date =>
new Date(Math.ceil(date.getTime() / HOUR_IN_MS) * HOUR_IN_MS - 1)
// The end of an hour for 2 September 2014 11:55:00:
module.exports = endOfHour(new Date(2014, 8, 2, 11, 55))
// => Tue Sep 02 2014 11:59:59.999
================================================
FILE: src/content/date-fns/04-hour/getHours/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getHours
import { getHours } from 'date-fns'
// Get the hours of 29 February 2012 11:45:00:
module.exports = getHours(new Date(2012, 1, 29, 11, 45))
// => 11
================================================
FILE: src/content/date-fns/04-hour/getHours/notes.md
================================================
Get the hours of the given date.
================================================
FILE: src/content/date-fns/04-hour/getHours/spec.js
================================================
const expected = 11
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getHours', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/getHours/vanilla.js
================================================
const getHours = date => date.getHours()
// Get the hours of 29 February 2012 11:45:00:
module.exports = getHours(new Date(2012, 1, 29, 11, 45))
// => 11
================================================
FILE: src/content/date-fns/04-hour/isSameHour/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSameHour
import { isSameHour } from 'date-fns'
// Are 4 September 2014 06:00:00 and 4 September 06:30:00 in the same hour?
module.exports = isSameHour(
new Date(2014, 8, 4, 6, 0),
new Date(2014, 8, 4, 6, 30)
)
// => true
================================================
FILE: src/content/date-fns/04-hour/isSameHour/notes.md
================================================
Are the given dates in the same hour?
================================================
FILE: src/content/date-fns/04-hour/isSameHour/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSameHour', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/isSameHour/vanilla.js
================================================
const HOUR_IN_MS = 1000 * 60 * 60
const isSameHour = (dateA, dateB) =>
Math.abs(dateA - dateB) < HOUR_IN_MS && dateA.getHours() === dateB.getHours()
// Are 4 September 2014 06:00:00 and 4 September 06:30:00 in the same hour?
module.exports = isSameHour(
new Date(2014, 8, 4, 6, 0),
new Date(2014, 8, 4, 6, 30)
)
// => true
================================================
FILE: src/content/date-fns/04-hour/isThisHour/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isThisHour
import { isThisHour } from 'date-fns'
// If now is 25 September 2014 18:30:15.500,
// is 25 September 2014 18:00:00 in this hour?
module.exports = isThisHour(new Date(2014, 8, 25, 18))
// => true
================================================
FILE: src/content/date-fns/04-hour/isThisHour/notes.md
================================================
Is the given date in the same hour as the current date?
================================================
FILE: src/content/date-fns/04-hour/isThisHour/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isThisHour', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/isThisHour/vanilla.js
================================================
const HOUR_IN_MS = 1000 * 60 * 60
const isThisHour = (dateA, dateB = new Date()) =>
Math.abs(dateA - dateB) < HOUR_IN_MS && dateA.getHours() === dateB.getHours()
// If now is 25 September 2014 18:30:15.500,
// is 25 September 2014 18:00:00 in this hour?
module.exports = isThisHour(new Date(2014, 8, 25, 18))
// => true
================================================
FILE: src/content/date-fns/04-hour/setHours/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setHours
import { setHours } from 'date-fns'
// Set 4 hours to 1 September 2014 11:30:00:
module.exports = setHours(new Date(2014, 8, 1, 11, 30), 4)
// => Mon Sep 01 2014 04:30:00
================================================
FILE: src/content/date-fns/04-hour/setHours/notes.md
================================================
Set the hours to the given date.
================================================
FILE: src/content/date-fns/04-hour/setHours/spec.js
================================================
const expected = new Date(2014, 8, 1, 4, 30)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setHours', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/setHours/vanilla.js
================================================
const setHours = (date, h) => {
date.setHours(h)
return date
}
// Set 4 hours to 1 September 2014 11:30:00:
module.exports = setHours(new Date(2014, 8, 1, 11, 30), 4)
// => Mon Sep 01 2014 04:30:00
================================================
FILE: src/content/date-fns/04-hour/startOfHour/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/startOfHour
import { startOfHour } from 'date-fns'
// The start of an hour for 2 September 2014 11:55:00:
module.exports = startOfHour(new Date(2014, 8, 2, 11, 55))
// => Tue Sep 02 2014 11:00:00
================================================
FILE: src/content/date-fns/04-hour/startOfHour/notes.md
================================================
Return the start of an hour for the given date.
================================================
FILE: src/content/date-fns/04-hour/startOfHour/spec.js
================================================
const expected = new Date(2014, 8, 2, 11)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('startOfHour', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/startOfHour/vanilla.js
================================================
const HOUR_IN_MS = 1000 * 60 * 60
const startOfHour = date => new Date(Math.floor(date / HOUR_IN_MS) * HOUR_IN_MS)
// The start of an hour for 2 September 2014 11:55:00:
module.exports = startOfHour(new Date(2014, 8, 2, 11, 55))
// => Tue Sep 02 2014 11:00:00
================================================
FILE: src/content/date-fns/04-hour/subHours/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subHours
import { subHours } from 'date-fns'
// Subtract 2 hours from 11 July 2014 01:00:00:
module.exports = subHours(new Date(2014, 6, 11, 1, 0), 2)
// => Thu Jul 10 2014 23:00:00
================================================
FILE: src/content/date-fns/04-hour/subHours/notes.md
================================================
Subtract the specified number of hours from the given date.
================================================
FILE: src/content/date-fns/04-hour/subHours/spec.js
================================================
const expected = new Date(2014, 6, 10, 23, 0)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subHours', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/04-hour/subHours/vanilla.js
================================================
const subHours = (date, h) => {
date.setHours(date.getHours() - h)
return date
}
// Subtract 2 hours from 11 July 2014 01:00:00:
module.exports = subHours(new Date(2014, 6, 11, 1, 0), 2)
// => Thu Jul 10 2014 23:00:00
================================================
FILE: src/content/date-fns/05-day/addDays/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addDays
import { addDays } from 'date-fns'
// Add 10 days to 1 September 2014:
module.exports = addDays(new Date(2014, 8, 1), 10)
// => Thu Sep 11 2014 00:00:00
================================================
FILE: src/content/date-fns/05-day/addDays/notes.md
================================================
Add the specified number of days to the given date.
================================================
FILE: src/content/date-fns/05-day/addDays/spec.js
================================================
const expected = new Date(2014, 8, 11)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addDays', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/addDays/vanilla.js
================================================
const addDays = (date, d) => {
date.setDate(date.getDate() + d)
return date
}
// Add 10 days to 1 September 2014:
module.exports = addDays(new Date(2014, 8, 1), 10)
// => Thu Sep 11 2014 00:00:00
================================================
FILE: src/content/date-fns/05-day/differenceInDays/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInDays
import { differenceInDays } from 'date-fns'
// How many full days are between
// 2 July 2011 23:00:00 and 2 July 2012 00:00:00?
exports.year = differenceInDays(
new Date(2012, 6, 2, 0, 0),
new Date(2011, 6, 2, 23, 0)
)
// => 365
// How many full days are between
// 2 July 2011 23:59:00 and 3 July 2011 00:01:00?
exports.none = differenceInDays(
new Date(2011, 6, 3, 0, 1),
new Date(2011, 6, 2, 23, 59)
)
// => 0
// How many full days are between
// 1 March 2020 0:00 and 1 June 2020 0:00 ?
exports.nintytwo = differenceInDays(new Date(2020, 5, 1), new Date(2020, 2, 1))
// => 92
================================================
FILE: src/content/date-fns/05-day/differenceInDays/notes.md
================================================
Get the number of full days between the given dates.
================================================
FILE: src/content/date-fns/05-day/differenceInDays/spec.js
================================================
const expected = {
year: 365,
none: 0,
nintytwo: 92,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInDays', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/differenceInDays/vanilla.js
================================================
const differenceInDays = (dateA, dateB) =>
Math.round((dateA - dateB) / (1000 * 60 * 60 * 24))
// How many full days are between
// 2 July 2011 23:00:00 and 2 July 2012 00:00:00?
exports.year = differenceInDays(
new Date(2012, 6, 2, 0, 0),
new Date(2011, 6, 2, 23, 0)
)
// => 365
// How many full days are between
// 2 July 2011 23:59:00 and 3 July 2011 00:01:00?
exports.none = differenceInDays(
new Date(2011, 6, 3, 0, 1),
new Date(2011, 6, 2, 23, 59)
)
// => 0
// How many full days are between
// 1 March 2020 0:00 and 1 June 2020 0:00 ?
exports.nintytwo = differenceInDays(new Date(2020, 5, 1), new Date(2020, 2, 1))
// => 92
================================================
FILE: src/content/date-fns/05-day/getDate/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getDate
import { getDate } from 'date-fns'
// Which day of the month is 29 February 2012?
module.exports = getDate(new Date(2012, 1, 29))
// => 29
================================================
FILE: src/content/date-fns/05-day/getDate/notes.md
================================================
Get the day of the month of the given date.
================================================
FILE: src/content/date-fns/05-day/getDate/spec.js
================================================
const expected = 29
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getDate', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/getDate/vanilla.js
================================================
const getDate = date => date.getDate()
// Which day of the month is 29 February 2012?
module.exports = getDate(new Date(2012, 1, 29))
// => 29
================================================
FILE: src/content/date-fns/05-day/getDayOfYear/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getDayOfYear
import { getDayOfYear } from 'date-fns'
// Which day of the year is 2 July 2014?
module.exports = getDayOfYear(new Date(2014, 6, 2))
// => 183
================================================
FILE: src/content/date-fns/05-day/getDayOfYear/notes.md
================================================
Get the day of the year of the given date.
================================================
FILE: src/content/date-fns/05-day/getDayOfYear/spec.js
================================================
const expected = 183
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getDayOfYear', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/getDayOfYear/vanilla.js
================================================
const DAY_IN_MS = 1000 * 60 * 60 * 24
const getDayOfYear = date =>
(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()) -
Date.UTC(date.getFullYear(), 0, 0)) /
DAY_IN_MS
// Which day of the year is 2 July 2014?
module.exports = getDayOfYear(new Date(2014, 6, 2))
// => 183
================================================
FILE: src/content/date-fns/05-day/isSameDay/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSameDay
import { isSameDay } from 'date-fns'
// Are 4 September 06:00:00 and 4 September 18:00:00 in the same day?
module.exports = isSameDay(
new Date(2014, 8, 4, 6, 0),
new Date(2014, 8, 4, 18, 0)
)
// => true
================================================
FILE: src/content/date-fns/05-day/isSameDay/notes.md
================================================
Are the given dates in the same day?
================================================
FILE: src/content/date-fns/05-day/isSameDay/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSameDay', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/isSameDay/vanilla.js
================================================
const isSameDay = (dateA, dateB) =>
dateA.toLocaleDateString() === dateB.toLocaleDateString()
// Are 4 September 06:00:00 and 4 September 18:00:00 in the same day?
module.exports = isSameDay(
new Date(2014, 8, 4, 6, 0),
new Date(2014, 8, 4, 18, 0)
)
// => true
================================================
FILE: src/content/date-fns/05-day/isToday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isToday
import { isToday } from 'date-fns'
// If today is 25 September 2014, is 25 September 14:00 today?
module.exports = isToday(new Date(2014, 8, 25, 14, 0))
// => true
================================================
FILE: src/content/date-fns/05-day/isToday/notes.md
================================================
Is the given date today?
================================================
FILE: src/content/date-fns/05-day/isToday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isToday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/isToday/vanilla.js
================================================
const isToday = date => {
const yesterday = new Date()
return yesterday.toLocaleDateString() === date.toLocaleDateString()
}
// If today is 25 September 2014, is 25 September 14:00 today?
module.exports = isToday(new Date(2014, 8, 25, 14, 0))
// => true
================================================
FILE: src/content/date-fns/05-day/isTomorrow/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isTomorrow
import { isTomorrow } from 'date-fns'
// If today is 25 September 2014, is 24 September tomorrow?
module.exports = isTomorrow(new Date(2014, 8, 26, 14, 0))
// => true
================================================
FILE: src/content/date-fns/05-day/isTomorrow/notes.md
================================================
Is the given date tomorrow?
================================================
FILE: src/content/date-fns/05-day/isTomorrow/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isTomorrow', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/isTomorrow/vanilla.js
================================================
const isTomorrow = date => {
const yesterday = new Date()
yesterday.setDate(yesterday.getDate() + 1)
return yesterday.toLocaleDateString() === date.toLocaleDateString()
}
// If today is 25 September 2014, is 24 September tomorrow?
module.exports = isTomorrow(new Date(2014, 8, 26, 14, 0))
// => true
================================================
FILE: src/content/date-fns/05-day/isYesterday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isYesterday
import { isYesterday } from 'date-fns'
// If today is 25 September 2014, is 24 September yesterday?
module.exports = isYesterday(new Date(2014, 8, 24, 14, 0))
// => true
================================================
FILE: src/content/date-fns/05-day/isYesterday/notes.md
================================================
Is the given date yesterday?
================================================
FILE: src/content/date-fns/05-day/isYesterday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isYesterday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/isYesterday/vanilla.js
================================================
const isYesterday = date => {
const yesterday = new Date()
yesterday.setDate(yesterday.getDate() - 1)
return yesterday.toLocaleDateString() === date.toLocaleDateString()
}
// If today is 25 September 2014, is 24 September yesterday?
module.exports = isYesterday(new Date(2014, 8, 24, 14, 0))
// => true
================================================
FILE: src/content/date-fns/05-day/setDate/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setDate
import { setDate } from 'date-fns'
// Set the 30th day of the month to 1 September 2014:
module.exports = setDate(new Date(2014, 8, 1), 30)
// => Tue Sep 30 2014 00:00:00
================================================
FILE: src/content/date-fns/05-day/setDate/notes.md
================================================
Set the day of the month to the given date.
================================================
FILE: src/content/date-fns/05-day/setDate/spec.js
================================================
const expected = new Date(2014, 8, 30)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setDate', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/setDate/vanilla.js
================================================
const setDate = (date, d) => {
date.setDate(d)
return date
}
// Set the 30th day of the month to 1 September 2014:
module.exports = setDate(new Date(2014, 8, 1), 30)
// => Tue Sep 30 2014 00:00:00
================================================
FILE: src/content/date-fns/05-day/subDays/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subDays
import { subDays } from 'date-fns'
// Subtract 10 days from 1 September 2014:
module.exports = subDays(new Date(2014, 8, 1), 10)
// => Fri Aug 22 2014 00:00:00
================================================
FILE: src/content/date-fns/05-day/subDays/notes.md
================================================
Subtract the specified number of days from the given date.
================================================
FILE: src/content/date-fns/05-day/subDays/spec.js
================================================
const expected = new Date(2014, 7, 22)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subDays', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/05-day/subDays/vanilla.js
================================================
const subDays = (date, d) => {
date.setDate(date.getDate() - d)
return date
}
// Subtract 10 days from 1 September 2014:
module.exports = subDays(new Date(2014, 8, 1), 10)
// => Fri Aug 22 2014 00:00:00
================================================
FILE: src/content/date-fns/06-weekday/getDay/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getDay
import { getDay } from 'date-fns'
// Which day of the week is 29 February 2012?
exports.randomday = getDay(new Date(2012, 1, 29))
// => 3
// Which day of the week is 26 February 2012?
exports.sunday = getDay(new Date(2012, 1, 26))
// => 0
================================================
FILE: src/content/date-fns/06-weekday/getDay/notes.md
================================================
Get the day of the week of the given date.
================================================
FILE: src/content/date-fns/06-weekday/getDay/spec.js
================================================
const expected = {
randomday: 3,
sunday: 0,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getDay', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/getDay/vanilla.js
================================================
const getDay = date => date.getDay()
// Which day of the week is 29 February 2012?
exports.randomday = getDay(new Date(2012, 1, 29))
// => 3
// Which day of the week is 26 February 2012?
exports.sunday = getDay(new Date(2012, 1, 26))
// => 0
================================================
FILE: src/content/date-fns/06-weekday/getISODay/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getISODay
import { getISODay } from 'date-fns'
// Which day of the week is 29 February 2012?
exports.day = getISODay(new Date(2012, 1, 29))
// => 3
// Which day of the week is 26 February 2012?
exports.sunday = getISODay(new Date(2012, 1, 26))
// => 7
================================================
FILE: src/content/date-fns/06-weekday/getISODay/notes.md
================================================
Get the day of the ISO week of the given date.
================================================
FILE: src/content/date-fns/06-weekday/getISODay/spec.js
================================================
const expected = {
day: 3,
sunday: 7,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getISODay', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/getISODay/vanilla.js
================================================
const getISODay = date => date.getDay() || 7
// Which day of the week is 29 February 2012?
exports.day = getISODay(new Date(2012, 1, 29))
// => 3
// Which day of the week is 26 February 2012?
exports.sunday = getISODay(new Date(2012, 1, 26))
// => 7
================================================
FILE: src/content/date-fns/06-weekday/isFriday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isFriday
import { isFriday } from 'date-fns'
// Is 26 September 2014 Friday?
module.exports = isFriday(new Date(2014, 8, 26))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isFriday/notes.md
================================================
Is the given date Friday?
================================================
FILE: src/content/date-fns/06-weekday/isFriday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isFriday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isFriday/vanilla.js
================================================
const isFriday = date => date.getDay() === 5
// Is 26 September 2014 Friday?
module.exports = isFriday(new Date(2014, 8, 26))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isMonday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isMonday
import { isMonday } from 'date-fns'
// Is 22 September 2014 Monday?
module.exports = isMonday(new Date(2014, 8, 22))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isMonday/notes.md
================================================
Is the given date Monday? (you could also check [Mondays](https://www.npmjs.com/package/mondays))
================================================
FILE: src/content/date-fns/06-weekday/isMonday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isMonday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isMonday/vanilla.js
================================================
const isMonday = date => date.getDay() === 1
// Is 22 September 2014 Monday?
module.exports = isMonday(new Date(2014, 8, 22))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isSaturday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSaturday
import { isSaturday } from 'date-fns'
// Is 27 September 2014 Saturday?
module.exports = isSaturday(new Date(2014, 8, 27))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isSaturday/notes.md
================================================
Is the given date Saturday?
================================================
FILE: src/content/date-fns/06-weekday/isSaturday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSaturday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isSaturday/vanilla.js
================================================
const isSaturday = date => date.getDay() === 6
// Is 27 September 2014 Saturday?
module.exports = isSaturday(new Date(2014, 8, 27))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isSunday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSunday
import { isSunday } from 'date-fns'
// Is 21 September 2014 Sunday?
module.exports = isSunday(new Date(2014, 8, 21))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isSunday/notes.md
================================================
Is the given date Sunday?
================================================
FILE: src/content/date-fns/06-weekday/isSunday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSunday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isSunday/vanilla.js
================================================
const isSunday = date => date.getDay() === 0
// Is 21 September 2014 Sunday?
module.exports = isSunday(new Date(2014, 8, 21))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isThursday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isThursday
import { isThursday } from 'date-fns'
// Is 25 September 2014 Thursday?
module.exports = isThursday(new Date(2014, 8, 25))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isThursday/notes.md
================================================
Is the given date Thursday?
================================================
FILE: src/content/date-fns/06-weekday/isThursday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isThursday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isThursday/vanilla.js
================================================
const isThursday = date => date.getDay() === 4
// Is 25 September 2014 Thursday?
module.exports = isThursday(new Date(2014, 8, 25))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isTuesday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isTuesday
import { isTuesday } from 'date-fns'
// Is 23 September 2014 Tuesday?
module.exports = isTuesday(new Date(2014, 8, 23))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isTuesday/notes.md
================================================
Is the given date Tuesday?
================================================
FILE: src/content/date-fns/06-weekday/isTuesday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isTuesday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isTuesday/vanilla.js
================================================
const isTuesday = date => date.getDay() === 2
// Is 23 September 2014 Tuesday?
module.exports = isTuesday(new Date(2014, 8, 23))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isWednesday/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isWednesday
import { isWednesday } from 'date-fns'
// Is 24 September 2014 Wednesday?
module.exports = isWednesday(new Date(2014, 8, 24))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isWednesday/notes.md
================================================
Is the given date Wednesday?
================================================
FILE: src/content/date-fns/06-weekday/isWednesday/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isWednesday', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isWednesday/vanilla.js
================================================
const isWednesday = date => date.getDay() === 3
// Is 24 September 2014 Wednesday?
module.exports = isWednesday(new Date(2014, 8, 24))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isWeekend/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isWeekend
import { isWeekend } from 'date-fns'
// Does 5 October 2014 fall on a weekend?
module.exports = isWeekend(new Date(2014, 9, 5))
// => true
================================================
FILE: src/content/date-fns/06-weekday/isWeekend/notes.md
================================================
Does the given date fall on a weekend?
================================================
FILE: src/content/date-fns/06-weekday/isWeekend/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isWeekend', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/06-weekday/isWeekend/vanilla.js
================================================
const isWeekend = date => [0, 6].includes(date.getDay())
// Does 5 October 2014 fall on a weekend?
module.exports = isWeekend(new Date(2014, 9, 5))
// => true
================================================
FILE: src/content/date-fns/07-week/addWeeks/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addWeeks
import { addWeeks } from 'date-fns'
// Add 4 weeks to 1 September 2014:
module.exports = addWeeks(new Date(2014, 8, 1), 4)
// => Mon Sep 29 2014 00:00:00
================================================
FILE: src/content/date-fns/07-week/addWeeks/notes.md
================================================
Add the specified number of weeks to the given date.
================================================
FILE: src/content/date-fns/07-week/addWeeks/spec.js
================================================
const expected = new Date(2014, 8, 29)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addWeeks', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/07-week/addWeeks/vanilla.js
================================================
const addWeeks = (date, w) => {
date.setDate(date.getDate() + w * 7)
return date
}
// Add 4 weeks to 1 September 2014:
module.exports = addWeeks(new Date(2014, 8, 1), 4)
// => Mon Sep 29 2014 00:00:00
================================================
FILE: src/content/date-fns/07-week/subWeeks/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subWeeks
import { subWeeks } from 'date-fns'
// Subtract 4 weeks from 1 September 2014:
module.exports = subWeeks(new Date(2014, 8, 1), 4)
// => Mon Aug 04 2014 00:00:00
================================================
FILE: src/content/date-fns/07-week/subWeeks/notes.md
================================================
Subtract the specified number of weeks from the given date.
================================================
FILE: src/content/date-fns/07-week/subWeeks/spec.js
================================================
const expected = new Date(2014, 7, 4)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subWeeks', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/07-week/subWeeks/vanilla.js
================================================
const subWeeks = (date, w) => {
date.setDate(date.getDate() - w * 7)
return date
}
// Subtract 4 weeks from 1 September 2014:
module.exports = subWeeks(new Date(2014, 8, 1), 4)
// => Mon Aug 04 2014 00:00:00
================================================
FILE: src/content/date-fns/08-month/addMonths/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addMonths
import { addMonths } from 'date-fns'
// Add 5 months to 1 September 2014:
module.exports = addMonths(new Date(2014, 8, 1), 5)
// => Sun Feb 01 2015 00:00:00
================================================
FILE: src/content/date-fns/08-month/addMonths/notes.md
================================================
Add the specified number of months to the given date.
================================================
FILE: src/content/date-fns/08-month/addMonths/spec.js
================================================
const expected = new Date(2015, 1, 1)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addMonths', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/addMonths/vanilla.js
================================================
const addMonths = (date, m) => {
date.setMonth(date.getMonth() + m)
return date
}
// Add 5 months to 1 September 2014:
module.exports = addMonths(new Date(2014, 8, 1), 5)
// => Sun Feb 01 2015 00:00:00
================================================
FILE: src/content/date-fns/08-month/getMonth/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getMonth
import { getMonth } from 'date-fns'
// Which month is 29 February 2012?
module.exports = getMonth(new Date(2012, 1, 29))
// => 1
================================================
FILE: src/content/date-fns/08-month/getMonth/notes.md
================================================
Get the month of the given date.
================================================
FILE: src/content/date-fns/08-month/getMonth/spec.js
================================================
const expected = 1
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/getMonth/vanilla.js
================================================
const getMonth = date => date.getMonth()
// Which month is 29 February 2012?
module.exports = getMonth(new Date(2012, 1, 29))
// => 1
================================================
FILE: src/content/date-fns/08-month/isFirstDayOfMonth/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isFirstDayOfMonth
import { isFirstDayOfMonth } from 'date-fns'
// Is 1 September 2014 the first day of a month?
module.exports = isFirstDayOfMonth(new Date(2014, 8, 1))
// => true
================================================
FILE: src/content/date-fns/08-month/isFirstDayOfMonth/notes.md
================================================
Is the given date the first day of a month?
================================================
FILE: src/content/date-fns/08-month/isFirstDayOfMonth/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isFirstDayOfMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/isFirstDayOfMonth/vanilla.js
================================================
const isFirstDayOfMonth = date => date.getDate() === 1
// Is 1 September 2014 the first day of a month?
module.exports = isFirstDayOfMonth(new Date(2014, 8, 1))
// => true
================================================
FILE: src/content/date-fns/08-month/isLastDayOfMonth/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isLastDayOfMonth
import { isLastDayOfMonth } from 'date-fns'
// Is 28 February 2014 the last day of a month?
module.exports = isLastDayOfMonth(new Date(2014, 1, 28))
// => true
================================================
FILE: src/content/date-fns/08-month/isLastDayOfMonth/notes.md
================================================
Is the given date the last day of a month?
================================================
FILE: src/content/date-fns/08-month/isLastDayOfMonth/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isLastDayOfMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/isLastDayOfMonth/vanilla.js
================================================
const isLastDayOfMonth = date => {
const dateClone = new Date(date.getTime())
dateClone.setDate(date.getDate() + 1)
return date.getMonth() === dateClone.getMonth() - 1
}
// Is 28 February 2014 the last day of a month?
module.exports = isLastDayOfMonth(new Date(2014, 1, 28))
// => true
================================================
FILE: src/content/date-fns/08-month/isSameMonth/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSameMonth
import { isSameMonth } from 'date-fns'
// Are 2 September 2014 and 25 September 2014 in the same month?
module.exports = isSameMonth(new Date(2014, 8, 2), new Date(2014, 8, 25))
// => true
================================================
FILE: src/content/date-fns/08-month/isSameMonth/notes.md
================================================
Are the given dates in the same month?
================================================
FILE: src/content/date-fns/08-month/isSameMonth/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSameMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/isSameMonth/vanilla.js
================================================
const isSameMonth = (dateA, dateB) =>
dateA.getYear() === dateB.getYear() && dateA.getMonth() === dateB.getMonth()
// Are 2 September 2014 and 25 September 2014 in the same month?
module.exports = isSameMonth(new Date(2014, 8, 2), new Date(2014, 8, 25))
// => true
================================================
FILE: src/content/date-fns/08-month/isThisMonth/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isThisMonth
import { isThisMonth } from 'date-fns'
// If today is 25 September 2014, is 15 September 2014 in this month?
module.exports = isThisMonth(new Date(2014, 8, 15))
// => true
================================================
FILE: src/content/date-fns/08-month/isThisMonth/notes.md
================================================
Is the given date in the same month as the current date?
================================================
FILE: src/content/date-fns/08-month/isThisMonth/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isThisMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/isThisMonth/vanilla.js
================================================
const isThisMonth = date => {
const now = new Date()
return date.getYear() === now.getYear() && date.getMonth() === now.getMonth()
}
// If today is 25 September 2014, is 15 September 2014 in this month?
module.exports = isThisMonth(new Date(2014, 8, 15))
// => true
================================================
FILE: src/content/date-fns/08-month/lastDayOfMonth/date-fns.js
================================================
// https://date-fns.org/v2.29.3/docs/lastDayOfMonth
import { lastDayOfMonth } from 'date-fns'
// Get the last day of a month.
module.exports = lastDayOfMonth(new Date(2014, 1, 25)).toDateString()
// => Fri Feb 28 2014
================================================
FILE: src/content/date-fns/08-month/lastDayOfMonth/notes.md
================================================
Get the last day of a month from date.
================================================
FILE: src/content/date-fns/08-month/lastDayOfMonth/spec.js
================================================
const expected = 'Fri Feb 28 2014'
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('lastDayOfMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/lastDayOfMonth/vanilla.js
================================================
function lastDayOfMonth(date) {
const dateClone = new Date(date.getTime())
const month = dateClone.getMonth()
dateClone.setDate(1)
dateClone.setMonth(month + 1)
dateClone.setDate(0)
return dateClone
}
// Get the last day of a month.
module.exports = lastDayOfMonth(new Date(2014, 1, 25)).toDateString()
// => Fri Feb 28 2014
================================================
FILE: src/content/date-fns/08-month/setMonth/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setMonth
import { setMonth } from 'date-fns'
// Set February to 1 September 2014:
module.exports = setMonth(new Date(2014, 8, 1), 1)
// => Sat Feb 01 2014 00:00:00
================================================
FILE: src/content/date-fns/08-month/setMonth/notes.md
================================================
Set the month to the given date.
================================================
FILE: src/content/date-fns/08-month/setMonth/spec.js
================================================
const expected = new Date(2014, 1, 1)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setMonth', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/setMonth/vanilla.js
================================================
const setMonth = (date, m) => {
date.setMonth(m)
return date
}
// Set February to 1 September 2014:
module.exports = setMonth(new Date(2014, 8, 1), 1)
// => Sat Feb 01 2014 00:00:00
================================================
FILE: src/content/date-fns/08-month/subMonths/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/subMonths
import { subMonths } from 'date-fns'
// Subtract 5 months from 1 February 2015:
module.exports = subMonths(new Date(2015, 1, 1), 5)
// => Mon Sep 01 2014 00:00:00
================================================
FILE: src/content/date-fns/08-month/subMonths/notes.md
================================================
Subtract the specified number of months from the given date.
================================================
FILE: src/content/date-fns/08-month/subMonths/spec.js
================================================
const expected = new Date(2014, 8, 1)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('subMonths', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/08-month/subMonths/vanilla.js
================================================
const subMonths = (date, m) => {
date.setMonth(date.getMonth() - m)
return date
}
// Subtract 5 months from 1 February 2015:
module.exports = subMonths(new Date(2015, 1, 1), 5)
// => Mon Sep 01 2014 00:00:00
================================================
FILE: src/content/date-fns/09-year/addYears/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/addYears
import { addYears } from 'date-fns'
// Add 5 years to 1 September 2014:
module.exports = addYears(new Date(2014, 8, 1), 5)
// => Sun Sep 01 2019 00:00:00
================================================
FILE: src/content/date-fns/09-year/addYears/notes.md
================================================
Add the specified number of years to the given date.
================================================
FILE: src/content/date-fns/09-year/addYears/spec.js
================================================
const expected = new Date(2019, 8, 1)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('addYears', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/addYears/vanilla.js
================================================
const addYears = (date, yearsToAdd) => {
date.setFullYear(date.getFullYear() + yearsToAdd)
return date
}
// Add 5 years to 1 September 2014:
module.exports = addYears(new Date(2014, 8, 1), 5)
// => Sun Sep 01 2019 00:00:00
================================================
FILE: src/content/date-fns/09-year/differenceInCalendarYears/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInCalendarYears
import { differenceInCalendarYears } from 'date-fns'
// How many calendar years are between 31 December 2013 and 11 February 2015?
module.exports = differenceInCalendarYears(
new Date(2015, 1, 11),
new Date(2013, 11, 31)
)
// => 2
================================================
FILE: src/content/date-fns/09-year/differenceInCalendarYears/notes.md
================================================
Get the number of calendar years between the given dates.
================================================
FILE: src/content/date-fns/09-year/differenceInCalendarYears/spec.js
================================================
const expected = 2
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInCalendarYears', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/differenceInCalendarYears/vanilla.js
================================================
const differenceInCalendarYears = (dateA, dateB) =>
Math.abs(dateA.getFullYear() - dateB.getFullYear())
// How many calendar years are between 31 December 2013 and 11 February 2015?
module.exports = differenceInCalendarYears(
new Date(2015, 1, 11),
new Date(2013, 11, 31)
)
// => 2
================================================
FILE: src/content/date-fns/09-year/differenceInYears/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/differenceInYears
import { differenceInYears } from 'date-fns'
// How many full years are between 31 December 2013 and 11 February 2015?
module.exports = differenceInYears(
new Date(2015, 1, 11),
new Date(2013, 11, 31)
)
// => 1
================================================
FILE: src/content/date-fns/09-year/differenceInYears/notes.md
================================================
Get the number of full years between the given dates.
================================================
FILE: src/content/date-fns/09-year/differenceInYears/spec.js
================================================
const expected = 1
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('differenceInYears', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/differenceInYears/vanilla.js
================================================
const YEAR_IN_MS = 1000 * 60 * 60 * 24 * 365
const differenceInYears = (dateA, dateB) =>
Math.floor((dateA - dateB) / YEAR_IN_MS)
// How many full years are between 31 December 2013 and 11 February 2015?
module.exports = differenceInYears(
new Date(2015, 1, 11),
new Date(2013, 11, 31)
)
// => 1
================================================
FILE: src/content/date-fns/09-year/getYear/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/getYear
import { getYear } from 'date-fns'
// Which year is 2 July 2014?
module.exports = getYear(new Date(2014, 6, 2))
// => 2014
================================================
FILE: src/content/date-fns/09-year/getYear/notes.md
================================================
Get the year of the given date.
================================================
FILE: src/content/date-fns/09-year/getYear/spec.js
================================================
const expected = 2014
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('getYear', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/getYear/vanilla.js
================================================
const getYear = date => date.getFullYear()
// Which year is 2 July 2014?
module.exports = getYear(new Date(2014, 6, 2))
// => 2014
================================================
FILE: src/content/date-fns/09-year/isLeapYear/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isLeapYear
import { isLeapYear } from 'date-fns'
// Is 1 September 2012 in the leap year?
exports.leap = isLeapYear(new Date(2012, 8, 1))
// => true
// Is 1 September 2013 in the leap year?
exports.notLeap = isLeapYear(new Date(2013, 8, 1))
// => false
================================================
FILE: src/content/date-fns/09-year/isLeapYear/notes.md
================================================
Is the given date in the leap year?
================================================
FILE: src/content/date-fns/09-year/isLeapYear/spec.js
================================================
const expected = {
leap: true,
notLeap: false,
}
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isLeapYear', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/isLeapYear/vanilla.js
================================================
const isLeapYear = date => {
const year = date.getFullYear()
return year % 100 === 0 ? year % 400 === 0 : year % 4 === 0
}
// Is 1 September 2012 in the leap year?
exports.leap = isLeapYear(new Date(2012, 8, 1))
// => true
// Is 1 September 2013 in the leap year?
exports.notLeap = isLeapYear(new Date(2013, 8, 1))
// => false
================================================
FILE: src/content/date-fns/09-year/isSameYear/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isSameYear
import { isSameYear } from 'date-fns'
// Are 2 September 2014 and 25 September 2014 in the same year?
module.exports = isSameYear(new Date(2014, 8, 2), new Date(2014, 8, 25))
// => true
================================================
FILE: src/content/date-fns/09-year/isSameYear/notes.md
================================================
Are the given dates in the same year?
================================================
FILE: src/content/date-fns/09-year/isSameYear/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isSameYear', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/isSameYear/vanilla.js
================================================
const isSameYear = (dateA, dateB) => dateA.getFullYear() === dateB.getFullYear()
// Are 2 September 2014 and 25 September 2014 in the same year?
module.exports = isSameYear(new Date(2014, 8, 2), new Date(2014, 8, 25))
// => true
================================================
FILE: src/content/date-fns/09-year/isThisYear/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/isThisYear
import { isThisYear } from 'date-fns'
// If today is 25 September 2014, is 2 July 2014 in this year?
module.exports = isThisYear(new Date(2014, 6, 2))
// => true
================================================
FILE: src/content/date-fns/09-year/isThisYear/notes.md
================================================
Is the given date in the same year as the current date?
================================================
FILE: src/content/date-fns/09-year/isThisYear/spec.js
================================================
const expected = true
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('isThisYear', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/isThisYear/vanilla.js
================================================
const isThisYear = dateA => dateA.getFullYear() === new Date().getFullYear()
module.exports = isThisYear(new Date())
// => true
================================================
FILE: src/content/date-fns/09-year/setYear/date-fns.js
================================================
// https://date-fns.org/v3.5.0/docs/setYear
import { setYear } from 'date-fns'
// Set year 2013 to 1 September 2014:
module.exports = setYear(new Date(2014, 8, 1), 2013)
// => Sun Sep 01 2013 00:00:00
================================================
FILE: src/content/date-fns/09-year/setYear/notes.md
================================================
Set the year to the given date.
================================================
FILE: src/content/date-fns/09-year/setYear/spec.js
================================================
const expected = new Date(2013, 8, 1)
const datefns = require('./date-fns')
const plain = require('./vanilla')
test('setYear', () => {
expect(datefns).toEqual(expected)
expect(plain).toEqual(datefns)
})
================================================
FILE: src/content/date-fns/09-year/setYear/vanilla.js
================================================
const setYear = (date, year) => {
date.setFullYear(year)
return date
}
// Set year 2013 to 1 September 2014:
module.exports = setYear(new Date(2014, 8, 1), 2013)
// => Sun Sep 01 2013 00:00:00
================================================
FILE: src/content/date-fns-missing.md
================================================
[<< back](/date-fns)
# YOU MIGHT NOT NEED DATE-FNS
## Generic Helpers
[format](https://date-fns.org/v3.5.0/docs/format)
[formatDistance](https://date-fns.org/v3.5.0/docs/formatDistance)
[formatDistanceStrict](https://date-fns.org/v3.5.0/docs/formatDistanceStrict)
[formatDistanceToNow](https://date-fns.org/v3.5.0/docs/formatDistanceToNow)
[formatDistanceToNowStrict](https://date-fns.org/v3.5.0/docs/formatDistanceToNowStrict)
[formatISO](https://date-fns.org/v3.5.0/docs/formatISO)
[formatISO9075](https://date-fns.org/v3.5.0/docs/formatISO9075)
[formatISODuration](https://date-fns.org/v3.5.0/docs/formatISODuration)
[formatRFC3339](https://date-fns.org/v3.5.0/docs/formatRFC3339)
[formatRFC7231](https://date-fns.org/v3.5.0/docs/formatRFC7231)
[formatRelative](https://date-fns.org/v3.5.0/docs/formatRelative)
[intervalToDuration](https://date-fns.org/v3.5.0/docs/intervalToDuration)
[lightFormat](https://date-fns.org/v3.5.0/docs/lightFormat)
[parse](https://date-fns.org/v3.5.0/docs/parse)
[parseISO](https://date-fns.org/v3.5.0/docs/parseISO)
[parseJSON](https://date-fns.org/v3.5.0/docs/parseJSON)
[set](https://date-fns.org/v3.5.0/docs/set)
[sub](https://date-fns.org/v3.5.0/docs/sub)
[toDate](https://date-fns.org/v3.5.0/docs/toDate)
## Interval Helpers
[eachMonthOfInterval](https://date-fns.org/v3.5.0/docs/eachMonthOfInterval)
[eachWeekOfInterval](https://date-fns.org/v3.5.0/docs/eachWeekOfInterval)
[eachWeekendOfInterval](https://date-fns.org/v3.5.0/docs/eachWeekendOfInterval)
[eachYearOfInterval](https://date-fns.org/v3.5.0/docs/eachYearOfInterval)
[getOverlappingDaysInIntervals](https://date-fns.org/v3.5.0/docs/getOverlappingDaysInIntervals)
## Day Helpers
[addBusinessDays](https://date-fns.org/v3.5.0/docs/addBusinessDays)
[differenceInBusinessDays](https://date-fns.org/v3.5.0/docs/differenceInBusinessDays)
[differenceInCalendarDays](https://date-fns.org/v3.5.0/docs/differenceInCalendarDays)
[endOfDay](https://date-fns.org/v3.5.0/docs/endOfDay)
[endOfTomorrow](https://date-fns.org/v3.5.0/docs/endOfTomorrow)
[endOfYesterday](https://date-fns.org/v3.5.0/docs/endOfYesterday)
[setDayOfYear](https://date-fns.org/v3.5.0/docs/setDayOfYear)
[startOfDay](https://date-fns.org/v3.5.0/docs/startOfDay)
[startOfToday](https://date-fns.org/v3.5.0/docs/startOfToday)
[startOfTomorrow](https://date-fns.org/v3.5.0/docs/startOfTomorrow)
[startOfYesterday](https://date-fns.org/v3.5.0/docs/startOfYesterday)
[subBusinessDays](https://date-fns.org/v3.5.0/docs/subBusinessDays)
## Weekday Helpers
[setDay](https://date-fns.org/v3.5.0/docs/setDay)
[setISODay](https://date-fns.org/v3.5.0/docs/setISODay)
## Week Helpers
[addWeeks](https://date-fns.org/v3.5.0/docs/addWeeks)
[differenceInCalendarWeeks](https://date-fns.org/v3.5.0/docs/differenceInCalendarWeeks)
[differenceInWeeks](https://date-fns.org/v3.5.0/docs/differenceInWeeks)
[endOfWeek](https://date-fns.org/v3.5.0/docs/endOfWeek)
[getWeek](https://date-fns.org/v3.5.0/docs/getWeek)
[getWeekOfMonth](https://date-fns.org/v3.5.0/docs/getWeekOfMonth)
[getWeeksInMonth](https://date-fns.org/v3.5.0/docs/getWeeksInMonth)
[isSameWeek](https://date-fns.org/v3.5.0/docs/isSameWeek)
[isThisWeek](https://date-fns.org/v3.5.0/docs/isThisWeek)
[lastDayOfWeek](https://date-fns.org/v3.5.0/docs/lastDayOfWeek)
[setWeek](https://date-fns.org/v3.5.0/docs/setWeek)
[startOfWeek](https://date-fns.org/v3.5.0/docs/startOfWeek)
[subWeeks](https://date-fns.org/v3.5.0/docs/subWeeks)
## ISO Week Helpers
[differenceInCalendarISOWeeks](https://date-fns.org/v3.5.0/docs/differenceInCalendarISOWeeks)
[endOfISOWeek](https://date-fns.org/v3.5.0/docs/endOfISOWeek)
[getISOWeek](https://date-fns.org/v3.5.0/docs/getISOWeek)
[isSameISOWeek](https://date-fns.org/v3.5.0/docs/isSameISOWeek)
[isThisISOWeek](https://date-fns.org/v3.5.0/docs/isThisISOWeek)
[lastDayOfISOWeek](https://date-fns.org/v3.5.0/docs/lastDayOfISOWeek)
[setISOWeek](https://date-fns.org/v3.5.0/docs/setISOWeek)
[startOfISOWeek](https://date-fns.org/v3.5.0/docs/startOfISOWeek)
## Month Helpers
[differenceInCalendarMonths](https://date-fns.org/v3.5.0/docs/differenceInCalendarMonths)
[differenceInMonths](https://date-fns.org/v3.5.0/docs/differenceInMonths)
[eachWeekendOfMonth](https://date-fns.org/v3.5.0/docs/eachWeekendOfMonth)
[endOfMonth](https://date-fns.org/v3.5.0/docs/endOfMonth)
[getDaysInMonth](https://date-fns.org/v3.5.0/docs/getDaysInMonth)
[startOfMonth](https://date-fns.org/v3.5.0/docs/startOfMonth)
## Quarter Helpers
[addQuarters](https://date-fns.org/v3.5.0/docs/addQuarters)
[differenceInCalendarQuarters](https://date-fns.org/v3.5.0/docs/differenceInCalendarQuarters)
[differenceInQuarters](https://date-fns.org/v3.5.0/docs/differenceInQuarters)
[endOfQuarter](https://date-fns.org/v3.5.0/docs/endOfQuarter)
[getQuarter](https://date-fns.org/v3.5.0/docs/getQuarter)
[isSameQuarter](https://date-fns.org/v3.5.0/docs/isSameQuarter)
[isThisQuarter](https://date-fns.org/v3.5.0/docs/isThisQuarter)
[lastDayOfQuarter](https://date-fns.org/v3.5.0/docs/lastDayOfQuarter)
[setQuarter](https://date-fns.org/v3.5.0/docs/setQuarter)
[startOfQuarter](https://date-fns.org/v3.5.0/docs/startOfQuarter)
[subQuarters](https://date-fns.org/v3.5.0/docs/subQuarters)
## Year Helpers
[eachWeekendOfYear](https://date-fns.org/v3.5.0/docs/eachWeekendOfYear)
[endOfYear](https://date-fns.org/v3.5.0/docs/endOfYear)
[getDaysInYear](https://date-fns.org/v3.5.0/docs/getDaysInYear)
[lastDayOfYear](https://date-fns.org/v3.5.0/docs/lastDayOfYear)
[startOfYear](https://date-fns.org/v3.5.0/docs/startOfYear)
[subYears](https://date-fns.org/v3.5.0/docs/subYears)
## ISO Week-Numbering Year Helpers
[addISOWeekYears](https://date-fns.org/v3.5.0/docs/addISOWeekYears)
[differenceInCalendarISOWeekYears](https://date-fns.org/v3.5.0/docs/differenceInCalendarISOWeekYears)
[differenceInISOWeekYears](https://date-fns.org/v3.5.0/docs/differenceInISOWeekYears)
[endOfISOWeekYear](https://date-fns.org/v3.5.0/docs/endOfISOWeekYear)
[getISOWeekYear](https://date-fns.org/v3.5.0/docs/getISOWeekYear)
[getISOWeeksInYear](https://date-fns.org/v3.5.0/docs/getISOWeeksInYear)
[isSameISOWeekYear](https://date-fns.org/v3.5.0/docs/isSameISOWeekYear)
[lastDayOfISOWeekYear](https://date-fns.org/v3.5.0/docs/lastDayOfISOWeekYear)
[setISOWeekYear](https://date-fns.org/v3.5.0/docs/setISOWeekYear)
[startOfISOWeekYear](https://date-fns.org/v3.5.0/docs/startOfISOWeekYear)
[subISOWeekYears](https://date-fns.org/v3.5.0/docs/subISOWeekYears)
## Decade Helpers
[endOfDecade](https://date-fns.org/v3.5.0/docs/endOfDecade)
[getDecade](https://date-fns.org/v3.5.0/docs/getDecade)
[lastDayOfDecade](https://date-fns.org/v3.5.0/docs/lastDayOfDecade)
[startOfDecade](https://date-fns.org/v3.5.0/docs/startOfDecade)
## Week-Numbering Year Helpers
[getWeekYear](https://date-fns.org/v3.5.0/docs/getWeekYear)
[setWeekYear](https://date-fns.org/v3.5.0/docs/setWeekYear)
[startOfWeekYear](https://date-fns.org/v3.5.0/docs/startOfWeekYear)
================================================
FILE: src/content/date-fns.md
================================================
# YOU MIGHT NOT NEED **DATE-FNS**
But **you should use date-fns**.
Not only it's a great library, battle tested and with a strong team, but also dates in javascript are a pain to work with, no point in dealing with them at a low level when there are such well crafted libraries around. **The goal of this project is _NOT_ to provide drop in replacements**, but to show how achieve similar functionalities in plain Javascript, to understand how things work behind the hood.
Being a learning platform, **some implementations have been simplified to make them more digestible, and they might miss edge cases** covered in the original version.
On top of that there are [a lot of methods yet to be ported](/date-fns/missing) including what's probably the most needed: [format](https://date-fns.org/v2.22.1/docs/format); please help [contributing on github](https://github.com/cedmax/youmightnotneed/blob/master/src/content/how-to-contribute.md).
================================================
FILE: src/content/footer.md
================================================
Curated by [cedmax](https://cedmax.com/)
Share photo by Sydney Rae
================================================
FILE: src/content/how-to-contribute.md
================================================
# How To Contribute
Feel free to open a PR on the [github repository](https://github.com/cedmax/youmightnotneed).
If you want to suggest any other framework or library please [open an issue](https://github.com/cedmax/youmightnotneed/issues/new), before the PR.
Please note we have a [Code of Conduct](https://github.com/cedmax/youmightnotneed/blob/master/CODE_OF_CONDUCT.md), make sure you follow it in all your interactions with the project.
Run `yarn contributors` to add yourself to the Readme.md
## How to add a method implementation
In order to add a method/section, run `yarn new` and follow the instructions.
## File structure
Please follow the current file structure:
```
lodash.js
notes.md
spec.js
vanilla.js
```
Please use the examples in the [lodash documentation](https://lodash.com/docs) for the lodash.js files, just add the appropriate import.
##### ./lodash/array/chunk/lodash.js
```javascript
import { chunk } from 'lodash'
module.exports = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3)
// => [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]
```
Note that both lodash and vanilla need to `module.exports` the result of their operations: it's hidden on the website, but necessary for testing purposes. If you have more example, feel free to use something like `exports.propertyNameThatMakesSense` and change the spec file accordingly.
##### ./lodash/collection/find/spec.js
```javascript
const expected = { user: 'barney', age: 36, active: true }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('find', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
```
The `notes.md` file is meant to contain external links relevant to the the vanilla implementation (where the implementation was found, if not original, mdn references or such).
##### ./lodash/array/tail/notes.md
```md
Description of the method
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Source](https://www.sitepoint.com/lodash-features-replace-es6/)
```
## How it make it work on local
`yarn` to install dependencies.
`yarn start` to launch the watch mode.
`yarn test` to launch the tests.
`yarn build` to create the built version in the `dist` folder.
================================================
FILE: src/content/lodash/array/chunk/lodash.js
================================================
// https://lodash.com/docs/#chunk
import { chunk } from 'lodash'
exports.noSize = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'])
// => [['a'], ['b'], ['c'], ['d'], ['e'], ['f'], ['g']]
exports.simple = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3)
// => [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]
exports.chunkSizeZero = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 0)
// => []
exports.chunkSizeNegative = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], -1)
// => []
================================================
FILE: src/content/lodash/array/chunk/notes.md
================================================
Creates an array of elements split into groups the length of size. If array can't be split evenly, the final chunk will be the remaining elements.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#splice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice)
================================================
FILE: src/content/lodash/array/chunk/spec.js
================================================
const expected = {
noSize: [['a'], ['b'], ['c'], ['d'], ['e'], ['f'], ['g']],
simple: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']],
chunkSizeZero: [],
chunkSizeNegative: [],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('chunk', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/chunk/vanilla.js
================================================
const chunk = (arr, chunkSize = 1, cache = []) => {
const tmp = [...arr]
if (chunkSize <= 0) return cache
while (tmp.length) cache.push(tmp.splice(0, chunkSize))
return cache
}
exports.noSize = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'])
// => [['a'], ['b'], ['c'], ['d'], ['e'], ['f'], ['g']]
exports.simple = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3)
// => [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]
exports.chunkSizeZero = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 0)
// => []
exports.chunkSizeNegative = chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], -1)
// => []
================================================
FILE: src/content/lodash/array/compact/lodash.js
================================================
// https://lodash.com/docs/#compact
import { compact } from 'lodash'
module.exports = compact([0, 1, 2])
// => [1, 2]
================================================
FILE: src/content/lodash/array/compact/notes.md
================================================
Creates an array with all falsey values removed. The values false, null, 0, "", undefined, and NaN are falsey.
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Source](https://www.reindex.io/blog/you-might-not-need-underscore/#create-a-copy-of-an-array-with-all-falsy-values-removed)
================================================
FILE: src/content/lodash/array/compact/spec.js
================================================
const expected = [1, 2]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('compact', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/compact/vanilla.js
================================================
module.exports = [0, 1, 2].filter(x => !!x)
// => [1, 2]
================================================
FILE: src/content/lodash/array/concat/lodash.js
================================================
// https://lodash.com/docs/#concat
import { concat } from 'lodash'
module.exports = concat([1], 2, [3], [[4]])
// => [1, 2, 3, [4]]
================================================
FILE: src/content/lodash/array/concat/notes.md
================================================
Creates a new array concatenating array with any additional arrays and/or values.
Resources: [Array#concat](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/concat) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_concat)
================================================
FILE: src/content/lodash/array/concat/spec.js
================================================
const expected = [1, 2, 3, [4]]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('concat', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/concat/vanilla.js
================================================
module.exports = [1].concat(2, [3], [[4]])
// => [1, 2, 3, [4]]
================================================
FILE: src/content/lodash/array/difference/lodash.js
================================================
// https://lodash.com/docs/#difference
import { difference } from 'lodash'
module.exports = difference([2, 1], [3, 2])
// => [1]
================================================
FILE: src/content/lodash/array/difference/notes.md
================================================
Creates an array of array values not included in the other given arrays.
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes)
================================================
FILE: src/content/lodash/array/difference/spec.js
================================================
const expected = [1]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('difference', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/difference/vanilla.js
================================================
const difference = (arr1, arr2) => arr1.filter(x => !arr2.includes(x))
module.exports = difference([2, 1], [3, 2])
// => [1]
================================================
FILE: src/content/lodash/array/differenceBy/lodash.js
================================================
// https://lodash.com/docs/#differenceBy
import { differenceBy } from 'lodash'
exports.arrays = differenceBy([2.1, 1.2], [2.3, 3.4], Math.floor)
// => [1.2]
// The `_.property` iteratee shorthand.
exports.objects = differenceBy([{ x: 2 }, { x: 1 }], [{ x: 1 }], 'x')
// => [{ 'x': 2 }]
================================================
FILE: src/content/lodash/array/differenceBy/notes.md
================================================
This method is like \_.difference except that it accepts iteratee which is invoked for each element of array and values to generate the criterion by which they're compared. The order and references of result values are determined by the first array. The iteratee is invoked with one argument: (value).
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes)
================================================
FILE: src/content/lodash/array/differenceBy/spec.js
================================================
const expected = {
arrays: [1.2],
objects: [{ x: 2 }],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('differenceBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/differenceBy/vanilla.js
================================================
const differenceBy = (arr1, arr2, iteratee) => {
if (typeof iteratee === 'string') {
const prop = iteratee
iteratee = item => item[prop]
}
return arr1.filter(c => !arr2.map(iteratee).includes(iteratee(c)))
}
exports.arrays = differenceBy([2.1, 1.2], [2.3, 3.4], Math.floor)
// => [1.2]
// The `_.property` iteratee shorthand.
exports.objects = differenceBy([{ x: 2 }, { x: 1 }], [{ x: 1 }], 'x')
// => [{ 'x': 2 }]
================================================
FILE: src/content/lodash/array/drop/lodash.js
================================================
// https://lodash.com/docs/#drop
import { drop } from 'lodash'
exports.simple = drop([1, 2, 3])
// => [2, 3]
exports.withNumber = drop([1, 2, 3], 2)
// => [3]
exports.withNumberVariant = drop([1, 2, 3], 5)
// => []
exports.withZero = drop([1, 2, 3], 0)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/array/drop/notes.md
================================================
Creates a slice of array with n elements dropped from the beginning.
Resources: [Default parameters](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Functions/Default_parameters) [Array#slice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/slice)
================================================
FILE: src/content/lodash/array/drop/spec.js
================================================
const expected = {
simple: [2, 3],
withNumber: [3],
withNumberVariant: [],
withZero: [1, 2, 3],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('drop', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/drop/vanilla.js
================================================
const drop = (arr, n = 1) => arr.slice(n)
exports.simple = drop([1, 2, 3])
// => [2, 3]
exports.withNumber = drop([1, 2, 3], 2)
// => [3]
exports.withNumberVariant = drop([1, 2, 3], 5)
// => []
exports.withZero = drop([1, 2, 3], 0)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/array/dropRight/lodash.js
================================================
// https://lodash.com/docs/#dropRight
import { dropRight } from 'lodash'
exports.simple = dropRight([1, 2, 3])
// => [1, 2]
exports.withNumber = dropRight([1, 2, 3], 2)
// => [1]
exports.withNumberVariant = dropRight([1, 2, 3], 5)
// => []
exports.withZero = dropRight([1, 2, 3], 0)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/array/dropRight/notes.md
================================================
Creates a slice of array with n elements dropped from the end.
Resources: [Default parameters](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Functions/Default_parameters) [Array#slice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/slice)
================================================
FILE: src/content/lodash/array/dropRight/spec.js
================================================
const expected = {
simple: [1, 2],
withNumber: [1],
withNumberVariant: [],
withZero: [1, 2, 3],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('dropRight', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/dropRight/vanilla.js
================================================
const dropRight = (arr, n = 1) => arr.slice(0, -n || arr.length)
exports.simple = dropRight([1, 2, 3])
// => [1, 2]
exports.withNumber = dropRight([1, 2, 3], 2)
// => [1]
exports.withNumberVariant = dropRight([1, 2, 3], 5)
// => []
exports.withZero = dropRight([1, 2, 3], 0)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/array/fill/lodash.js
================================================
// https://lodash.com/docs/#fill
import { fill } from 'lodash'
exports.array = fill([1, 2, 3], 'a')
// => ['a', 'a', 'a']
exports.arrayConstructor = fill(Array(3), 2)
// => [2, 2, 2]
exports.partial = fill([4, 6, 8, 10], '*', 1, 3)
// => [4, '*', '*', 10]
================================================
FILE: src/content/lodash/array/fill/notes.md
================================================
Fills elements of array with value from start up to, but not including, end.
Resources: [Array#find](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/find) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_find)
================================================
FILE: src/content/lodash/array/fill/spec.js
================================================
const expected = {
array: ['a', 'a', 'a'],
arrayConstructor: [2, 2, 2],
partial: [4, '*', '*', 10],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('fill', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/fill/vanilla.js
================================================
exports.array = [1, 2, 3].fill('a')
// => ['a', 'a', 'a']
exports.arrayConstructor = Array(3).fill(2)
// => [2, 2, 2]
exports.partial = [4, 6, 8, 10].fill('*', 1, 3)
// => [4, '*', '*', 10]
================================================
FILE: src/content/lodash/array/findIndex/lodash.js
================================================
// https://lodash.com/docs/#findIndex
import { findIndex } from 'lodash'
const users = [
{ user: 'barney', age: 36, active: true },
{ user: 'fred', age: 40, active: false },
{ user: 'pebbles', age: 1, active: true },
]
module.exports = findIndex(users, o => o.age >= 40)
// => 1
================================================
FILE: src/content/lodash/array/findIndex/notes.md
================================================
This method is like \_.find except that it returns the index of the first element predicate returns truthy for instead of the element itself.
Resources: [Array#findIndex](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_findindex)
================================================
FILE: src/content/lodash/array/findIndex/spec.js
================================================
const expected = 1
const lodash = require('./lodash')
const plain = require('./vanilla')
test('findIndex', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/findIndex/vanilla.js
================================================
const users = [
{ user: 'barney', age: 36, active: true },
{ user: 'fred', age: 40, active: false },
{ user: 'pebbles', age: 1, active: true },
]
module.exports = users.findIndex(o => o.age >= 40)
// => 1
================================================
FILE: src/content/lodash/array/findLastIndex/lodash.js
================================================
// https://lodash.com/docs/#findLastIndex
import { findLastIndex } from 'lodash'
const users = [
{ user: 'barney', active: true },
{ user: 'fred', active: false },
{ user: 'pebbles', active: false },
]
exports.found = findLastIndex(users, o => !o.active)
// => 2
exports.notFound = findLastIndex(users, o => !o.user)
// => -1
================================================
FILE: src/content/lodash/array/findLastIndex/notes.md
================================================
This method is like \_.findIndex except that it iterates over elements of collection from right to left.
Resources: [Array#findLastIndex](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/findLastIndex)
================================================
FILE: src/content/lodash/array/findLastIndex/spec.js
================================================
const expected = {
found: 2,
notFound: -1,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('findLastIndex', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/findLastIndex/vanilla.js
================================================
const users = [
{ user: 'barney', active: true },
{ user: 'fred', active: false },
{ user: 'pebbles', active: false },
]
exports.found = users.findLastIndex(o => !o.active)
// => 2
exports.notFound = users.findLastIndex(o => !o.user)
// => -1
================================================
FILE: src/content/lodash/array/flatMap/lodash.js
================================================
// https://lodash.com/docs/#flatMap
import { flatMap } from 'lodash'
module.exports = flatMap([1, 2], n => [n, n])
// => [1, 1, 2, 2]
================================================
FILE: src/content/lodash/array/flatMap/notes.md
================================================
Returns a new array formed by applying a given callback function to each element
of the array, and then flattening the result by one level.
Resources:
[Array#flatMap](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap)
================================================
FILE: src/content/lodash/array/flatMap/spec.js
================================================
const expected = [1, 1, 2, 2]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('flatMap', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/flatMap/vanilla.js
================================================
module.exports = [1, 2].flatMap(n => [n, n])
// => [1, 1, 2, 2]
================================================
FILE: src/content/lodash/array/flatten/lodash.js
================================================
// https://lodash.com/docs/#flatten
import { flatten } from 'lodash'
module.exports = flatten([1, [2, [3, [4]], 5]])
// => [1, 2, [3, [4]], 5]
================================================
FILE: src/content/lodash/array/flatten/notes.md
================================================
Flattens array a single level deep.
Resources: [Array#flat](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/flat) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_flatten)
================================================
FILE: src/content/lodash/array/flatten/spec.js
================================================
const expected = [1, 2, [3, [4]], 5]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('flatten', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/flatten/vanilla.js
================================================
module.exports = [1, [2, [3, [4]], 5]].flat()
// => [1, 2, [3, [4]], 5]
================================================
FILE: src/content/lodash/array/flattenDeep/lodash.js
================================================
// https://lodash.com/docs/#flattenDeep
import { flattenDeep } from 'lodash'
module.exports = flattenDeep([1, [2, [3, [4]], 5]])
// => [1, 2, 3, 4, 5]
================================================
FILE: src/content/lodash/array/flattenDeep/notes.md
================================================
Recursively flattens array.
Resources: [Array#flat](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/flat#flattening_nested_arrays) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_flattenDeep)
================================================
FILE: src/content/lodash/array/flattenDeep/spec.js
================================================
const expected = [1, 2, 3, 4, 5]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('flattenDeep', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/flattenDeep/vanilla.js
================================================
module.exports = [1, [[2], [3, [4]], 5]].flat(Infinity)
// => [1, 2, 3, 4, 5]
================================================
FILE: src/content/lodash/array/flattenDepth/lodash.js
================================================
// https://lodash.com/docs/#flattenDepth
import { flattenDepth } from 'lodash'
var array = [1, [2, [3, [4]], 5]]
exports.example1 = flattenDepth(array, 1)
// => [1, 2, [3, [4]], 5]
exports.example2 = flattenDepth(array, 2)
// => [1, 2, 3, [4], 5]
================================================
FILE: src/content/lodash/array/flattenDepth/notes.md
================================================
Recursively flatten array up to depth times.
Resources: [Array#flat](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/flat#flattening_nested_arrays)
================================================
FILE: src/content/lodash/array/flattenDepth/spec.js
================================================
const expected = {
example1: [1, 2, [3, [4]], 5],
example2: [1, 2, 3, [4], 5],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('flattenDepth', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/flattenDepth/vanilla.js
================================================
const flattenDepth = (arr, depth) => arr.flat(depth)
var array = [1, [2, [3, [4]], 5]]
exports.example1 = flattenDepth(array, 1)
// => [1, 2, [3, [4]], 5]
exports.example2 = flattenDepth(array, 2)
// => [1, 2, 3, [4], 5]
================================================
FILE: src/content/lodash/array/fromPairs/lodash.js
================================================
// https://lodash.com/docs/#fromPairs
import { fromPairs } from 'lodash'
module.exports = fromPairs([
['a', 1],
['b', 2],
])
// => { 'a': 1, 'b': 2 }
================================================
FILE: src/content/lodash/array/fromPairs/notes.md
================================================
The inverse of \_.toPairs; this method returns an object composed from key-value pairs.
Resources: [Object.fromEntries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/fromEntries)
================================================
FILE: src/content/lodash/array/fromPairs/spec.js
================================================
const expected = { a: 1, b: 2 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('fromPairs', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/fromPairs/vanilla.js
================================================
module.exports = Object.fromEntries([
['a', 1],
['b', 2],
])
// => { 'a': 1, 'b': 2 }
================================================
FILE: src/content/lodash/array/head/.eslintrc
================================================
{
"rules": {
"no-unused-vars": 0
}
}
================================================
FILE: src/content/lodash/array/head/lodash.js
================================================
// https://lodash.com/docs/#head
import { head } from 'lodash'
module.exports = head([1, 2, 3])
// => 1
================================================
FILE: src/content/lodash/array/head/notes.md
================================================
Gets the first element of array.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Source](https://www.sitepoint.com/lodash-features-replace-es6/)
================================================
FILE: src/content/lodash/array/head/spec.js
================================================
const expected = 1
const lodash = require('./lodash')
const plain = require('./vanilla')
test('head', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/head/vanilla.js
================================================
const [head] = [1, 2, 3]
module.exports = head
// => 1
================================================
FILE: src/content/lodash/array/indexOf/lodash.js
================================================
// https://lodash.com/docs/#indexOf
import { indexOf } from 'lodash'
module.exports = indexOf([1, 2, 3], 3)
// => 2
================================================
FILE: src/content/lodash/array/indexOf/notes.md
================================================
Gets the index at which the first occurrence of value is found in array.
Resources: [Array#indexOf](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf)
================================================
FILE: src/content/lodash/array/indexOf/spec.js
================================================
const expected = 2
const lodash = require('./lodash')
const plain = require('./vanilla')
test('indexOf', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/indexOf/vanilla.js
================================================
module.exports = [1, 2, 3].indexOf(3)
// => 2
================================================
FILE: src/content/lodash/array/initial/lodash.js
================================================
// https://lodash.com/docs/#initial
import { initial } from 'lodash'
module.exports = initial([1, 2, 3])
// => [1, 2]
================================================
FILE: src/content/lodash/array/initial/notes.md
================================================
Gets all but the last element of array.
Resources: [Array#slice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/slice)
================================================
FILE: src/content/lodash/array/initial/spec.js
================================================
const expected = [1, 2]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('head', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/initial/vanilla.js
================================================
module.exports = [1, 2, 3].slice(0, -1)
// => [1, 2]
================================================
FILE: src/content/lodash/array/intersection/lodash.js
================================================
// https://lodash.com/docs/#intersection
import { intersection } from 'lodash'
module.exports = intersection([2, 1], [2, 3])
// => [2]
================================================
FILE: src/content/lodash/array/intersection/notes.md
================================================
Creates an array of unique values that are included in all given arrays.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#every](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/every)
================================================
FILE: src/content/lodash/array/intersection/spec.js
================================================
const expected = [2]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('intersection', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/intersection/vanilla.js
================================================
const intersection = (arr, ...args) =>
arr.filter(item => args.every(arr => arr.includes(item)))
module.exports = intersection([2, 1], [2, 3])
// => [2]
================================================
FILE: src/content/lodash/array/intersectionBy/lodash.js
================================================
// https://lodash.com/docs/#intersectionBy
import { intersectionBy } from 'lodash'
exports.default = intersectionBy([2.1, 1.2], [2.3, 3.4], Math.floor)
// => [2.1]
// The `_.property` iteratee shorthand.
exports.property = intersectionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x')
// => [{ 'x': 1 }]
================================================
FILE: src/content/lodash/array/intersectionBy/notes.md
================================================
This method is like \_.intersection except that it accepts iteratee which is invoked for each element of each arrays to generate the criterion by which they're compared. The order and references of result values are determined by the first array. The iteratee is invoked with one argument: (value).
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#pop](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/pop) [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#every](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/every) [Array#find](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/find)
================================================
FILE: src/content/lodash/array/intersectionBy/spec.js
================================================
const expected = {
default: [2.1],
property: [{ 'x': 1 }],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('intersectionBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/intersectionBy/vanilla.js
================================================
const intersectionBy = (arr, ...args) => {
let iteratee = args.pop()
if (typeof iteratee === 'string') {
const prop = iteratee
iteratee = item => item[prop]
}
return arr.filter(item1 =>
args.every(arr2 => arr2.find(item2 => iteratee(item1) === iteratee(item2)))
)
}
exports.default = intersectionBy([2.1, 1.2], [2.3, 3.4], Math.floor)
// => [2.1]
// The `_.property` iteratee shorthand.
exports.property = intersectionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x')
// => [{ 'x': 1 }]
================================================
FILE: src/content/lodash/array/join/lodash.js
================================================
// https://lodash.com/docs/#join
import { join } from 'lodash'
module.exports = join(['a', 'b', 'c'], '~')
// => 'a~b~c'
================================================
FILE: src/content/lodash/array/join/notes.md
================================================
Converts all elements in array into a string separated by separator.
Resources: [Array#join](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/join)
================================================
FILE: src/content/lodash/array/join/spec.js
================================================
const expected = 'a~b~c'
const lodash = require('./lodash')
const plain = require('./vanilla')
test('join', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/join/vanilla.js
================================================
module.exports = ['a', 'b', 'c'].join('~')
// => 'a~b~c'
================================================
FILE: src/content/lodash/array/last/lodash.js
================================================
// https://lodash.com/docs/#last
import { last } from 'lodash'
module.exports = last(['a', 'b', 'c'])
// => 'c'
================================================
FILE: src/content/lodash/array/last/notes.md
================================================
Gets the last element of array.
================================================
FILE: src/content/lodash/array/last/spec.js
================================================
const expected = 'c'
const lodash = require('./lodash')
const plain = require('./vanilla')
test('last', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/last/vanilla.js
================================================
const arr = ['a', 'b', 'c']
module.exports = arr[arr.length - 1]
// => 'c'
================================================
FILE: src/content/lodash/array/lastIndexOf/lodash.js
================================================
// https://lodash.com/docs/#lastIndexOf
import { lastIndexOf } from 'lodash'
exports.simple = lastIndexOf([1, 2, 1, 2], 2)
// => 3
// Search from the `fromIndex`
exports.fromIndex = lastIndexOf([1, 2, 1, 2], 2, 2)
// => 1
================================================
FILE: src/content/lodash/array/lastIndexOf/notes.md
================================================
This method is like \_.indexOf except that it iterates over elements of array from right to left.
Resources: [Array#lastIndexOf](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/lastIndexOf)
================================================
FILE: src/content/lodash/array/lastIndexOf/spec.js
================================================
const expected = {
simple: 3,
fromIndex: 1,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('lastIndexOf', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/lastIndexOf/vanilla.js
================================================
exports.simple = [1, 2, 1, 2].lastIndexOf(2)
// => 3
// Search from the `fromIndex`
exports.fromIndex = [1, 2, 1, 2].lastIndexOf(2, 2)
// => 1
================================================
FILE: src/content/lodash/array/nth/lodash.js
================================================
// https://lodash.com/docs/#nth
import { nth } from 'lodash'
const array = ['a', 'b', 'c', 'd']
exports.simple = nth(array, 1)
// => 'b'
exports.negative = nth(array, -2)
// => 'c';
================================================
FILE: src/content/lodash/array/nth/notes.md
================================================
Gets the element at index n of array. If n is negative, the nth element from the end is returned.
Resources: [Array#slice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/slice)
================================================
FILE: src/content/lodash/array/nth/spec.js
================================================
const expected = {
simple: 'b',
negative: 'c',
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('nth', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/nth/vanilla.js
================================================
const nth = (arr, idx) => arr.slice(idx, idx + 1)[0]
const array = ['a', 'b', 'c', 'd']
exports.simple = nth(array, 1)
// => 'b'
exports.negative = nth(array, -2)
// => 'c';
================================================
FILE: src/content/lodash/array/pull/lodash.js
================================================
// https://lodash.com/docs/#pull
import { pull } from 'lodash'
var array = ['a', 'b', 'c', 'a', 'b', 'c']
pull(array, 'a', 'c')
module.exports = array
// => ['b', 'b']
================================================
FILE: src/content/lodash/array/pull/notes.md
================================================
Removes all given values from array using SameValueZero for equality comparisons.
Note: Unlike _.without, this method mutates array. Use _.remove to remove elements from an array by predicate.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#forEach](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach) [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes) [Array#splice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice) [Array#indexOf](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf)
================================================
FILE: src/content/lodash/array/pull/spec.js
================================================
const expected = ['b', 'b']
const lodash = require('./lodash')
const plain = require('./vanilla')
test('pull', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/pull/vanilla.js
================================================
const pull = (array, ...values) => {
values.forEach(value => {
while (array.includes(value)) {
array.splice(array.indexOf(value), 1)
}
})
return array
}
var array = ['a', 'b', 'c', 'a', 'b', 'c']
pull(array, 'a', 'c')
module.exports = array
// => ['b', 'b']
================================================
FILE: src/content/lodash/array/pullAt/lodash.js
================================================
// https://lodash.com/docs/#pullAt
import { pullAt } from 'lodash'
const array = ['a', 'b', 'c', 'd']
exports.return = pullAt(array, [1, 3])
// => ['b', 'd']
exports.array = array
// => ['a', 'c']
================================================
FILE: src/content/lodash/array/pullAt/notes.md
================================================
Removes elements from array corresponding to indexes and returns an array of removed elements.
Resources: [Array#reverse](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse) [Array#splice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice)
================================================
FILE: src/content/lodash/array/pullAt/spec.js
================================================
const expected = {
return: ['b', 'd'],
array: ['a', 'c'],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('pullAt', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/pullAt/vanilla.js
================================================
const pullAt = (arr, idxs) =>
idxs
.reverse()
.map(idx => arr.splice(idx, 1)[0])
.reverse()
const array = ['a', 'b', 'c', 'd']
exports.return = pullAt(array, [1, 3])
// => ['b', 'd']
exports.array = array
// => ['a', 'c']
================================================
FILE: src/content/lodash/array/reject/lodash.js
================================================
// https://lodash.com/docs/#reject
import { reject } from 'lodash'
module.exports = reject(
['a', 'b', 'c', 'd', 'e', 'f', 'g'],
char => char === 'd'
)
// => [['a', 'b', 'c', 'e', 'f', 'g']]
================================================
FILE: src/content/lodash/array/reject/notes.md
================================================
The opposite of \_.filter; this method returns the elements of collection that predicate does not return truthy for.
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter)
================================================
FILE: src/content/lodash/array/reject/spec.js
================================================
const expected = ['a', 'b', 'c', 'e', 'f', 'g']
const lodash = require('./lodash')
const plain = require('./vanilla')
test('reject', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/reject/vanilla.js
================================================
module.exports = ['a', 'b', 'c', 'd', 'e', 'f', 'g'].filter(
char => char !== 'd'
)
// => [['a', 'b', 'c', 'e', 'f', 'g']]
================================================
FILE: src/content/lodash/array/remove/lodash.js
================================================
// https://lodash.com/docs/#remove
import { remove } from 'lodash'
const array = [1, 2, 3, 4]
const evens = remove(array, n => {
return n % 2 === 0
})
exports.array = array
// => [1, 3]
exports.evens = evens
// => [2, 4]
const newArray = [1, 2, 3, 4, 5]
exports.all = remove(newArray, () => newArray.length > 0)
// => [1, 2, 3, 4, 5]
exports.newArray = newArray
// => []
================================================
FILE: src/content/lodash/array/remove/notes.md
================================================
Removes all elements from array that predicate returns truthy for and returns an array of the removed elements. The predicate is invoked with three arguments: (value, index, array).
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#splice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice)
================================================
FILE: src/content/lodash/array/remove/spec.js
================================================
const expected = {
array: [1, 3],
evens: [2, 4],
newArray: [],
all: [1, 2, 3, 4, 5],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('remove', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/remove/vanilla.js
================================================
const remove = (array, iteratee) => {
// in order to not mutate the original array until the very end
// we want to cache the indexes to remove while preparing the result to return
const toRemove = []
const result = array.filter((item, i) => iteratee(item) && toRemove.push(i))
// just before returning, we can then remove the items, making sure we start
// from the higher indexes: otherwise they would shift at each removal
toRemove.reverse().forEach(i => array.splice(i, 1))
return result
}
const array = [1, 2, 3, 4]
const evens = remove(array, n => {
return n % 2 === 0
})
exports.array = array
// => [1, 3]
exports.evens = evens
// => [2, 4]
const newArray = [1, 2, 3, 4, 5]
exports.all = remove(newArray, () => newArray.length > 0)
// => [1, 2, 3, 4, 5]
exports.newArray = newArray
// => []
================================================
FILE: src/content/lodash/array/reverse/lodash.js
================================================
// https://lodash.com/docs/#reverse
import { reverse } from 'lodash'
const array = [1, 2, 3]
exports.return = reverse(array)
// => [3, 2, 1]
exports.mutated = array
// => [3, 2, 1]
================================================
FILE: src/content/lodash/array/reverse/notes.md
================================================
Reverses array so that the first element becomes the last, the second element becomes the second to last, and so on.
Resources: [Array#reverse](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse)
================================================
FILE: src/content/lodash/array/reverse/spec.js
================================================
const expected = {
return: [3, 2, 1],
mutated: [3, 2, 1],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('reverse', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/reverse/vanilla.js
================================================
const array = [1, 2, 3]
exports.return = array.reverse()
// => [3, 2, 1]
exports.mutated = array
// => [3, 2, 1]
================================================
FILE: src/content/lodash/array/slice/lodash.js
================================================
// https://lodash.com/docs/#slice
import { slice } from 'lodash'
exports.array = slice([1, 2, 3, 4], 2, 6)
// => [ 3, 4 ]
const array = []
array[6] = 6
array[9] = 9
exports.undefined = slice(array, 2, 6)
// => [ undefined, undefined, undefined, undefined ]
================================================
FILE: src/content/lodash/array/slice/notes.md
================================================
Creates a slice of array from start up to, but not including, end.
Note: This method is used instead of Array#slice to ensure dense arrays are returned.
Resources: [Sparse vs Dense Arrays](https://remysharp.com/2018/06/26/an-adventure-in-sparse-arrays)
================================================
FILE: src/content/lodash/array/slice/spec.js
================================================
const expected = {
array: [3, 4],
undefined: [undefined, undefined, undefined, undefined],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
describe('slice', () => {
test('normal behaviour', () => {
expect(lodash.array).toEqual(expected.array)
expect(plain.array).toEqual(lodash.array)
})
test('empty array are dense', () => {
const denseExpected = expected.undefined.map(v => typeof v)
const denseLodash = lodash.undefined.map(v => typeof v)
const densePlain = plain.undefined.map(v => typeof v)
expect(denseLodash).toEqual(denseExpected)
expect(densePlain).toEqual(denseLodash)
})
})
================================================
FILE: src/content/lodash/array/slice/vanilla.js
================================================
const slice = (arr, start, end) => [...arr.slice(start, end)]
exports.array = slice([1, 2, 3, 4], 2, 6)
// => [ 3, 4 ]
const array = []
array[6] = 6
array[9] = 9
exports.undefined = slice(array, 2, 6)
// => [ undefined, undefined, undefined, undefined ]
================================================
FILE: src/content/lodash/array/sortedIndexOf/lodash.js
================================================
// https://lodash.com/docs/#sortedIndexOf
import { sortedIndexOf } from 'lodash'
module.exports = sortedIndexOf([4, 5, 5, 5, 6], 5)
// => 1
================================================
FILE: src/content/lodash/array/sortedIndexOf/notes.md
================================================
This method is like \_.indexOf except that it performs the search on a sorted array.
Resources: [Array#sort](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/sort) [Array#indexOf](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/indexOf)
================================================
FILE: src/content/lodash/array/sortedIndexOf/spec.js
================================================
const expected = 1
const lodash = require('./lodash')
const plain = require('./vanilla')
test('sortedIndexOf', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/sortedIndexOf/vanilla.js
================================================
const sortedIndexOf = (arr, value) => [...arr].sort().indexOf(value)
module.exports = sortedIndexOf([4, 5, 5, 5, 6], 5)
// => 1
================================================
FILE: src/content/lodash/array/sortedLastIndexOf/lodash.js
================================================
// https://lodash.com/docs/#sortedLastIndexOf
import { sortedLastIndexOf } from 'lodash'
module.exports = sortedLastIndexOf([4, 5, 5, 5, 6], 5)
// => 3
================================================
FILE: src/content/lodash/array/sortedLastIndexOf/notes.md
================================================
This method is like \_.sortedIndex except that it returns the highest index at which value should be inserted into array in order to maintain its sort order.
Resources: [Array#sort](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/sort) [Array#lastIndexOf](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/lastIndexOf)
================================================
FILE: src/content/lodash/array/sortedLastIndexOf/spec.js
================================================
const expected = 3
const lodash = require('./lodash')
const plain = require('./vanilla')
test('sortedLastIndexOf', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/sortedLastIndexOf/vanilla.js
================================================
// https://lodash.com/docs/#sortedLastIndexOf
const sortedLastIndexOf = (arr, value) => [...arr].sort().lastIndexOf(value)
module.exports = sortedLastIndexOf([4, 5, 5, 5, 6], 5)
// => 3
================================================
FILE: src/content/lodash/array/sortedUniq/lodash.js
================================================
// https://lodash.com/docs/#sortedUniq
import { sortedUniq } from 'lodash'
module.exports = sortedUniq([1, 1, 2])
// => [1, 2]
================================================
FILE: src/content/lodash/array/sortedUniq/notes.md
================================================
This method is like \_.uniq except that it's designed and optimized for sorted arrays.
Resources: [Set](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set) [Array#sort](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/sort)
================================================
FILE: src/content/lodash/array/sortedUniq/spec.js
================================================
const expected = [1, 2]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('sortedUniq', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/sortedUniq/vanilla.js
================================================
const sortedUniq = arr => [...new Set(arr)].sort()
module.exports = sortedUniq([1, 1, 2])
// => [1, 2]
================================================
FILE: src/content/lodash/array/tail/.eslintrc
================================================
{
"rules": {
"no-unused-vars": 0
}
}
================================================
FILE: src/content/lodash/array/tail/lodash.js
================================================
// https://lodash.com/docs/#tail
import { tail } from 'lodash'
module.exports = tail([1, 2, 3])
// => [2, 3]
================================================
FILE: src/content/lodash/array/tail/notes.md
================================================
Gets all but the first element of array.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Source](https://www.sitepoint.com/lodash-features-replace-es6/)
================================================
FILE: src/content/lodash/array/tail/spec.js
================================================
const expected = [2, 3]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('tail', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/tail/vanilla.js
================================================
const [, ...tail] = [1, 2, 3]
module.exports = tail
// => [2, 3]
================================================
FILE: src/content/lodash/array/take/lodash.js
================================================
// https://lodash.com/docs/#take
import { take } from 'lodash'
exports.default = take([1, 2, 3])
// => [1]
exports.two = take([1, 2, 3], 2)
// => [1, 2]
exports.all = take([1, 2, 3], 5)
// => [1, 2, 3]
exports.none = take([1, 2, 3], 0)
// => []
================================================
FILE: src/content/lodash/array/take/notes.md
================================================
Creates a slice of array with n elements taken from the beginning.
Resources: [Default parameters](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Functions/Default_parameters) [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#splice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice)
================================================
FILE: src/content/lodash/array/take/spec.js
================================================
const expected = {
default: [1],
two: [1, 2],
all: [1, 2, 3],
none: [],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('take', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/take/vanilla.js
================================================
const take = (arr, qty = 1) => [...arr].splice(0, qty)
exports.default = take([1, 2, 3])
// => [1]
exports.two = take([1, 2, 3], 2)
// => [1, 2]
exports.all = take([1, 2, 3], 5)
// => [1, 2, 3]
exports.none = take([1, 2, 3], 0)
// => []
================================================
FILE: src/content/lodash/array/takeRight/lodash.js
================================================
// https://lodash.com/docs/#takeRight
import { takeRight } from 'lodash'
exports.default = takeRight([1, 2, 3])
// => [3]
exports.two = takeRight([1, 2, 3], 2)
// => [2, 3]
exports.all = takeRight([1, 2, 3], 5)
// => [1, 2, 3]
exports.none = takeRight([1, 2, 3], 0)
// => []
================================================
FILE: src/content/lodash/array/takeRight/notes.md
================================================
Creates a slice of array with n elements taken from the end.
Resources: [Default parameters](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Functions/Default_parameters) [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#splice](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice)
================================================
FILE: src/content/lodash/array/takeRight/spec.js
================================================
const expected = {
default: [3],
two: [2, 3],
all: [1, 2, 3],
none: [],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('takeRight', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/takeRight/vanilla.js
================================================
const takeRight = (arr, qty = 1) => [...arr].splice(-qty, qty)
exports.default = takeRight([1, 2, 3])
// => [3]
exports.two = takeRight([1, 2, 3], 2)
// => [2, 3]
exports.all = takeRight([1, 2, 3], 5)
// => [1, 2, 3]
exports.none = takeRight([1, 2, 3], 0)
// => []
================================================
FILE: src/content/lodash/array/toPairs/lodash.js
================================================
// https://lodash.com/docs/#toPairs
import { toPairs } from 'lodash'
function Foo() {
this.a = 1
this.b = 2
}
Foo.prototype.c = 3
module.exports = toPairs(new Foo())
// => [['a', 1], ['b', 2]] (iteration order is not guaranteed)
================================================
FILE: src/content/lodash/array/toPairs/notes.md
================================================
Creates an array of own enumerable string keyed-value pairs for object which can be consumed by \_.fromPairs. If object is a map or set, its entries are returned.
Resources: [Object.entries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries)
================================================
FILE: src/content/lodash/array/toPairs/spec.js
================================================
const expected = [
['a', 1],
['b', 2],
]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('toPairs', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/toPairs/vanilla.js
================================================
function Foo() {
this.a = 1
this.b = 2
}
Foo.prototype.c = 3
module.exports = Object.entries(new Foo())
// => [['a', 1], ['b', 2]] (iteration order is not guaranteed)
================================================
FILE: src/content/lodash/array/union/lodash.js
================================================
// https://lodash.com/docs/#union
import { union } from 'lodash'
module.exports = union([2], [1, 2], [1, 2])
// => [2, 1]
================================================
FILE: src/content/lodash/array/union/notes.md
================================================
Creates an array of unique values, in order, from all given arrays.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Set](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set)
================================================
FILE: src/content/lodash/array/union/spec.js
================================================
const expected = [2, 1]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('union', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/union/vanilla.js
================================================
const union = (arr, ...args) => [...new Set(arr.concat(...args))]
module.exports = union([2], [1, 2], [1, 2])
// => [2, 1]
================================================
FILE: src/content/lodash/array/unionBy/lodash.js
================================================
// https://lodash.com/docs/#unionBy
import { unionBy } from 'lodash'
exports.default = unionBy([2.1], [1.2, 2.3], Math.floor)
// => [2.1, 1.2]
// The `_.property` iteratee shorthand.
exports.property = unionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x')
// => [{ 'x': 1 }, { 'x': 2 }]
// _.uniqBy example
exports.uniqBy = unionBy([2.1, 1.2, 2.3], Math.floor)
// => [2.1, 1.2]
================================================
FILE: src/content/lodash/array/unionBy/notes.md
================================================
This method is like \_.union except that it accepts iteratee which is invoked for each element of each arrays to generate the criterion by which uniqueness is computed. Result values are chosen from the first array in which the value occurs. The iteratee is invoked with one argument: (value).
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#pop](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/pop) [Array#concat](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/concat) [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#findIndex](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex)
================================================
FILE: src/content/lodash/array/unionBy/spec.js
================================================
const expected = {
default: [2.1, 1.2],
property: [{ 'x': 1 }, { 'x': 2 }],
uniqBy: [2.1, 1.2],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('unionBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/unionBy/vanilla.js
================================================
// This implementation also works for
// https://youmightnotneed.com/lodash#uniqBy
// by passing only one array as an argument
// before the iteratee function
const unionBy = (arr, ...args) => {
let iteratee = args.pop()
if (typeof iteratee === 'string') {
const prop = iteratee
iteratee = item => item[prop]
}
return arr
.concat(...args)
.filter(
(x, i, self) => i === self.findIndex(y => iteratee(x) === iteratee(y))
)
}
exports.default = unionBy([2.1], [1.2, 2.3], Math.floor)
// => [2.1, 1.2]
// The `_.property` iteratee shorthand.
exports.property = unionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x')
// => [{ 'x': 1 }, { 'x': 2 }]
// _.uniqBy example
exports.uniqBy = unionBy([2.1, 1.2, 2.3], Math.floor)
// => [2.1, 1.2]
================================================
FILE: src/content/lodash/array/uniq/lodash.js
================================================
// https://lodash.com/docs/#uniq
import { uniq } from 'lodash'
module.exports = uniq([2, 1, 2])
// => [2, 1]
================================================
FILE: src/content/lodash/array/uniq/notes.md
================================================
Creates a duplicate-free version of an array, in which only the first occurrence of each element is kept. The order of result values is determined by the order they occur in the array.
Resources: [Set](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set) [Source](https://www.reindex.io/blog/you-might-not-need-underscore/)
================================================
FILE: src/content/lodash/array/uniq/spec.js
================================================
const expected = [2, 1]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('uniq', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/uniq/vanilla.js
================================================
module.exports = [...new Set([2, 1, 2])]
// => [2, 1]
================================================
FILE: src/content/lodash/array/uniqBy/lodash.js
================================================
// https://lodash.com/docs/#uniqBy
import { uniqBy } from 'lodash'
exports.default = uniqBy([2.1, 1.2, 2.3], Math.floor)
// => [2.1, 1.2]
// The `_.property` iteratee shorthand.
exports.property = uniqBy([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x')
// => [{ 'x': 1 }, { 'x': 2 }]
================================================
FILE: src/content/lodash/array/uniqBy/notes.md
================================================
This method is like \_.uniq except that it accepts iteratee which is invoked for each element in array to generate the criterion by which uniqueness is computed. The order of result values is determined by the order they occur in the array. The iteratee is invoked with one argument: (value).
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#findIndex](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex)
================================================
FILE: src/content/lodash/array/uniqBy/spec.js
================================================
const expected = {
default: [2.1, 1.2],
property: [{ 'x': 1 }, { 'x': 2 }],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('uniqBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/uniqBy/vanilla.js
================================================
// This is a simplified implementation
// of https://youmightnotneed.com/lodash#unionBy
// which would work with only one array
const uniqBy = (arr, iteratee) => {
if (typeof iteratee === 'string') {
const prop = iteratee
iteratee = item => item[prop]
}
return arr.filter(
(x, i, self) => i === self.findIndex(y => iteratee(x) === iteratee(y))
)
}
exports.default = uniqBy([2.1, 1.2, 2.3], Math.floor)
// => [2.1, 1.2]
// The `_.property` iteratee shorthand.
exports.property = uniqBy([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x')
// => [{ 'x': 1 }, { 'x': 2 }]
================================================
FILE: src/content/lodash/array/unzip/lodash.js
================================================
// https://lodash.com/docs/#unzip
import { unzip } from 'lodash'
module.exports = unzip([
['a', 1, true],
['b', 2, false],
])
// => [['a', 'b'], [1, 2], [true, false]]
================================================
FILE: src/content/lodash/array/unzip/notes.md
================================================
This method is like \_.zip except that it accepts an array of grouped elements and creates an array regrouping the elements to their pre-zip configuration.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/map)
================================================
FILE: src/content/lodash/array/unzip/spec.js
================================================
const expected = [
['a', 'b'],
[1, 2],
[true, false],
]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('unzip', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/unzip/vanilla.js
================================================
const zip = (arr, ...args) =>
arr.map((value, idx) => [value, ...args.map(arr => arr[idx])])
const unzip = ([...args]) => zip(...args)
module.exports = unzip([
['a', 1, true],
['b', 2, false],
])
// => [['a', 'b'], [1, 2], [true, false]]
================================================
FILE: src/content/lodash/array/without/lodash.js
================================================
// https://lodash.com/docs/#without
import { without } from 'lodash'
const array = [2, 1, 2, 3]
exports.return = without(array, 1, 2)
// => [3]
exports.array = array
// => [2, 1, 2, 3]
================================================
FILE: src/content/lodash/array/without/notes.md
================================================
Creates an array excluding all given values.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes)
================================================
FILE: src/content/lodash/array/without/spec.js
================================================
const expected = {
return: [3],
array: [2, 1, 2, 3],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('without', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/without/vanilla.js
================================================
const without = (arr, ...args) => arr.filter(item => !args.includes(item))
const array = [2, 1, 2, 3]
exports.return = without(array, 1, 2)
// => [3]
exports.array = array
// => [2, 1, 2, 3]
================================================
FILE: src/content/lodash/array/xor/lodash.js
================================================
// https://lodash.com/docs/#xor
import { xor } from 'lodash'
module.exports.unique = xor([2, 1, 4], [2, 3, 2, 6])
// => [1, 4, 3, 6]
module.exports.duplicates = xor([1, 1, 2], [2, 2, 3])
// => [1, 3]
module.exports.variadic = xor([1], [2], [1, 3], [2, 4])
// => [3, 4]
================================================
FILE: src/content/lodash/array/xor/notes.md
================================================
Creates an array of unique values that is the symmetric difference of the given arrays. The order of result values is determined by the order they occur in the arrays.
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes)
================================================
FILE: src/content/lodash/array/xor/spec.js
================================================
const expected = {
unique: [1, 4, 3, 6],
duplicates: [1, 3],
variadic: [3, 4],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('xor', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/xor/vanilla.js
================================================
// this function can be used as a standalone xor if you only
// ever need it to work with two arguments
const binaryXor = (arr1, arr2) => {
const a = arr1.filter(x => !arr2.includes(x))
const b = arr2.filter(x => !arr1.includes(x))
return Array.from(new Set([...a, ...b]))
}
const xor = (...arrays) => arrays.reduce(binaryXor, [])
module.exports.unique = xor([2, 1, 4], [2, 3, 2, 6])
// => [1, 4, 3, 6]
module.exports.duplicates = xor([1, 1, 2], [2, 2, 3])
// => [1, 3]
module.exports.variadic = xor([1], [2], [1, 3], [2, 4])
// => [3, 4]
================================================
FILE: src/content/lodash/array/zip/lodash.js
================================================
// https://lodash.com/docs/#zip
import { zip } from 'lodash'
module.exports = zip(['a', 'b'], [1, 2], [true, false])
// => [['a', 1, true], ['b', 2, false]]
================================================
FILE: src/content/lodash/array/zip/notes.md
================================================
Creates an array of grouped elements, the first of which contains the first elements of the given arrays, the second of which contains the second elements of the given arrays, and so on.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/map)
================================================
FILE: src/content/lodash/array/zip/spec.js
================================================
const expected = [
['a', 1, true],
['b', 2, false],
]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('zip', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/zip/vanilla.js
================================================
const zip = (arr, ...args) =>
arr.map((value, idx) => [value, ...args.map(arr => arr[idx])])
module.exports = zip(['a', 'b'], [1, 2], [true, false])
// => [['a', 1, true], ['b', 2, false]]
================================================
FILE: src/content/lodash/array/zipObject/lodash.js
================================================
// https://lodash.com/docs/#zipObject
import { zipObject } from 'lodash'
module.exports = zipObject(['a', 'b'], [1, 2])
// => { 'a': 1, 'b': 2 }
================================================
FILE: src/content/lodash/array/zipObject/notes.md
================================================
This method is like \_.fromPairs except that it accepts two arrays, one of property identifiers and one of corresponding values.
Resources: [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/array/zipObject/spec.js
================================================
const expected = { a: 1, b: 2 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('zipObject', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/array/zipObject/vanilla.js
================================================
const zipObject = (keys, values) =>
keys.reduce((acc, key, idx) => {
acc[key] = values[idx]
return acc
}, {})
module.exports = zipObject(['a', 'b'], [1, 2])
// => { 'a': 1, 'b': 2 }
================================================
FILE: src/content/lodash/collection/every/lodash.js
================================================
// https://lodash.com/docs/#every
import { every } from 'lodash'
function isLargerThanTen(element) {
return element >= 10
}
module.exports = every([10, 20, 30], isLargerThanTen)
// => true
================================================
FILE: src/content/lodash/collection/every/notes.md
================================================
Checks if predicate returns truthy for all elements of collection. Iteration is stopped once predicate returns falsey. The predicate is invoked with three arguments: (value, index|key, collection).
Resources: [Array#every](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/every) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_every)
================================================
FILE: src/content/lodash/collection/every/spec.js
================================================
const expected = true
const lodash = require('./lodash')
const plain = require('./vanilla')
test('every', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/every/vanilla.js
================================================
function isLargerThanTen(element) {
return element >= 10
}
module.exports = [10, 20, 30].every(isLargerThanTen)
// => true
================================================
FILE: src/content/lodash/collection/filter/lodash.js
================================================
// https://lodash.com/docs/#filter
import { filter } from 'lodash'
function isBigEnough(value) {
return value >= 10
}
module.exports = filter([12, 5, 8, 130, 44], isBigEnough)
// => [12, 130, 44]
================================================
FILE: src/content/lodash/collection/filter/notes.md
================================================
Iterates over elements of collection, returning an array of all elements predicate returns truthy for. The predicate is invoked with three arguments: (value, index|key, collection).
Resources: [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_filter)
================================================
FILE: src/content/lodash/collection/filter/spec.js
================================================
const expected = [12, 130, 44]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('filter', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/filter/vanilla.js
================================================
function isBigEnough(value) {
return value >= 10
}
module.exports = [12, 5, 8, 130, 44].filter(isBigEnough)
// => [12, 130, 44]
================================================
FILE: src/content/lodash/collection/find/lodash.js
================================================
// https://lodash.com/docs/#find
import { find } from 'lodash'
const users = [
{ user: 'barney', age: 36, active: true },
{ user: 'fred', age: 40, active: false },
{ user: 'pebbles', age: 1, active: true },
]
module.exports = find(users, o => o.age < 40)
// => { user: "barney", age: 36, active: true }
================================================
FILE: src/content/lodash/collection/find/notes.md
================================================
Iterates over elements of collection, returning the first element predicate returns truthy for. The predicate is invoked with three arguments: (value, index|key, collection).
Resources: [Array#find](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/find) [Source](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore#_find)
================================================
FILE: src/content/lodash/collection/find/spec.js
================================================
const expected = { user: 'barney', age: 36, active: true }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('find', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/find/vanilla.js
================================================
const users = [
{ user: 'barney', age: 36, active: true },
{ user: 'fred', age: 40, active: false },
{ user: 'pebbles', age: 1, active: true },
]
module.exports = users.find(o => o.age < 40)
// => { user: "barney", age: 36, active: true }
================================================
FILE: src/content/lodash/collection/forEach/lodash.js
================================================
// https://lodash.com/docs/#forEach
import { forEach } from 'lodash'
const array = ['a', 'b', 'c']
forEach(array, (item, index) => {
console.log(item, index)
})
// => a 0
// => b 1
// => c 2
const obj = { a: 'red', b: 'green' }
forEach(obj, (item, key) => {
console.log(item, key)
})
// => red a
// => green b
================================================
FILE: src/content/lodash/collection/forEach/notes.md
================================================
Iterates over elements of collection and invokes iteratee for each element. The iteratee is invoked with three arguments: (value, index|key, collection). Iteratee functions may exit iteration early by explicitly returning false.
Resources: [Array#forEach](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach) [Object#entries](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries) [Source](https://www.reindex.io/blog/you-might-not-need-underscore/#iterate)
================================================
FILE: src/content/lodash/collection/forEach/spec.js
================================================
describe('forEach', () => {
describe('lodash', () => {
const logCache = console.log
beforeAll(() => {
console.log = jest.fn()
require('./lodash')
})
afterAll(() => {
console.log = logCache
})
test('log has been called correctly', () => {
expect(console.log).toHaveBeenNthCalledWith(1, 'a', 0)
expect(console.log).toHaveBeenNthCalledWith(2, 'b', 1)
expect(console.log).toHaveBeenNthCalledWith(3, 'c', 2)
expect(console.log).toHaveBeenNthCalledWith(4, 'red', 'a')
expect(console.log).toHaveBeenNthCalledWith(5, 'green', 'b')
})
})
describe('vanilla', () => {
const logCache = console.log
beforeAll(() => {
console.log = jest.fn()
require('./vanilla')
})
afterAll(() => {
console.log = logCache
})
test('log has been called correctly', () => {
expect(console.log).toHaveBeenNthCalledWith(1, 'a', 0)
expect(console.log).toHaveBeenNthCalledWith(2, 'b', 1)
expect(console.log).toHaveBeenNthCalledWith(3, 'c', 2)
expect(console.log).toHaveBeenNthCalledWith(4, 'red', 'a')
expect(console.log).toHaveBeenNthCalledWith(5, 'green', 'b')
})
})
})
================================================
FILE: src/content/lodash/collection/forEach/vanilla.js
================================================
['a', 'b', 'c'].forEach((item, index) => {
console.log(item, index)
})
// => a 0
// => b 1
// => c 2
Object.entries({ a: 'red', b: 'green' }).forEach(([key, item]) => {
console.log(item, key)
})
// => red a
// => green b
================================================
FILE: src/content/lodash/collection/forEachRight/lodash.js
================================================
// https://lodash.com/docs/#forEachRight
import { forEachRight } from 'lodash'
const array = ['a', 'b', 'c']
module.exports = forEachRight(array, (item, index) => {
console.log(item, index)
})
// => c 2
// => b 1
// => a 0
================================================
FILE: src/content/lodash/collection/forEachRight/notes.md
================================================
This method is like \_.forEach except that it iterates over elements of collection from right to left.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#reverse](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse) [Array#forEach](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach)
================================================
FILE: src/content/lodash/collection/forEachRight/spec.js
================================================
describe('forEach', () => {
describe('lodash', () => {
const logCache = console.log
beforeAll(() => {
console.log = jest.fn()
require('./lodash')
})
afterAll(() => {
console.log = logCache
})
test('log has been called correctly', () => {
expect(console.log).toHaveBeenNthCalledWith(1, 'c', 2)
expect(console.log).toHaveBeenNthCalledWith(2, 'b', 1)
expect(console.log).toHaveBeenNthCalledWith(3, 'a', 0)
})
})
describe('vanilla', () => {
const logCache = console.log
beforeAll(() => {
console.log = jest.fn()
require('./vanilla')
})
afterAll(() => {
console.log = logCache
})
test('log has been called correctly', () => {
expect(console.log).toHaveBeenNthCalledWith(1, 'c', 2)
expect(console.log).toHaveBeenNthCalledWith(2, 'b', 1)
expect(console.log).toHaveBeenNthCalledWith(3, 'a', 0)
})
})
})
================================================
FILE: src/content/lodash/collection/forEachRight/vanilla.js
================================================
const forEachRight = (array, iteratee) =>
[...array].reverse().forEach((val, index) => {
iteratee(val, array.length - 1 - index, array)
})
const array = ['a', 'b', 'c']
module.exports = forEachRight(array, (item, index) => {
console.log(item, index)
})
// => c 2
// => b 1
// => a 0
================================================
FILE: src/content/lodash/collection/includes/lodash.js
================================================
// https://lodash.com/docs/#includes
import { includes } from 'lodash'
module.exports = includes([1, 2, 3], 1)
// => true
================================================
FILE: src/content/lodash/collection/includes/notes.md
================================================
Checks if value is in collection. If collection is a string, it's checked for a substring of value. If fromIndex is negative, it's used as the offset from the end of collection.
Resources: [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes) [Source](https://www.sitepoint.com/lodash-features-replace-es6/)
================================================
FILE: src/content/lodash/collection/includes/spec.js
================================================
const expected = true
const lodash = require('./lodash')
const plain = require('./vanilla')
test('includes', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/includes/vanilla.js
================================================
module.exports = [1, 2, 3].includes(1)
// => true
================================================
FILE: src/content/lodash/collection/map/lodash.js
================================================
// https://lodash.com/docs/#map
import { map } from 'lodash'
module.exports = map([1, 2, 3], n => n * 3)
// => [3, 6, 9]
================================================
FILE: src/content/lodash/collection/map/notes.md
================================================
Creates an array of values by running each element in collection thru iteratee. The iteratee is invoked with three arguments: (value, index|key, collection).
Resources: [Array#map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/map) [Source](https://www.sitepoint.com/lodash-features-replace-es6/)
================================================
FILE: src/content/lodash/collection/map/spec.js
================================================
const expected = [3, 6, 9]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('map', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/map/vanilla.js
================================================
module.exports = [1, 2, 3].map(n => n * 3)
// => [3, 6, 9]
================================================
FILE: src/content/lodash/collection/reduce/lodash.js
================================================
// https://lodash.com/docs/#reduce
import { reduce } from 'lodash'
exports.array = reduce([1, 2], (sum, n) => sum + n, 0)
// => 3
exports.object = reduce(
{ a: 1, b: 2, c: 1 },
(result, value, key) => {
;(result[value] || (result[value] = [])).push(key)
return result
},
{}
)
// => { '1': ['a', 'c'], '2': ['b'] } (iteration order is not guaranteed)
================================================
FILE: src/content/lodash/collection/reduce/notes.md
================================================
Reduces collection to a value which is the accumulated result of running each element in collection thru iteratee, where each successive invocation is supplied the return value of the previous. If accumulator is not given, the first element of collection is used as the initial value. The iteratee is invoked with four arguments: (accumulator, value, index|key, collection).
Resources: [Object.entries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries) [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/collection/reduce/spec.js
================================================
const expected = {
array: 3,
object: { 1: ['a', 'c'], 2: ['b'] },
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('reduce', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/reduce/vanilla.js
================================================
exports.array = [1, 2].reduce((sum, n) => sum + n, 0)
// => 3
exports.object = Object.entries({ a: 1, b: 2, c: 1 }).reduce(
(result, [key, value]) => {
;(result[value] || (result[value] = [])).push(key)
return result
},
{}
)
// => { '1': ['a', 'c'], '2': ['b'] } (iteration order is not guaranteed)
================================================
FILE: src/content/lodash/collection/reduceRight/lodash.js
================================================
// https://lodash.com/docs/#reduceRight
import { reduceRight } from 'lodash'
module.exports = reduceRight(
[
[0, 1],
[2, 3],
[4, 5],
],
(flattened, other) => flattened.concat(other),
[]
)
// => [4, 5, 2, 3, 0, 1]
================================================
FILE: src/content/lodash/collection/reduceRight/notes.md
================================================
This method is like \_.reduce except that it iterates over elements of collection from right to left.
Resources: [Array#reduceRight](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduceRight) [Source](https://www.reindex.io/blog/you-might-not-need-underscore/)
================================================
FILE: src/content/lodash/collection/reduceRight/spec.js
================================================
const expected = [4, 5, 2, 3, 0, 1]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('reduceRight', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/reduceRight/vanilla.js
================================================
module.exports = [
[0, 1],
[2, 3],
[4, 5],
].reduceRight((flattened, other) => flattened.concat(other), [])
// => [4, 5, 2, 3, 0, 1]
================================================
FILE: src/content/lodash/collection/size/lodash.js
================================================
// https://lodash.com/docs/#size
import { size } from 'lodash'
exports.array = size([1, 2, 3])
// => 3
exports.object = size({ a: 1, b: 2 })
// => 2
exports.string = size('pebbles')
// => 7
================================================
FILE: src/content/lodash/collection/size/notes.md
================================================
Gets the size of collection by returning its length for array-like values or the number of own enumerable string keyed properties for objects.
Resources: [Object.keys](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/keys) [Source](https://www.reindex.io/blog/you-might-not-need-underscore/)
================================================
FILE: src/content/lodash/collection/size/spec.js
================================================
const expected = {
array: 3,
object: 2,
string: 7,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('size', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/size/vanilla.js
================================================
const size = item =>
item.constructor === Object ? Object.keys(item).length : item.length
exports.array = size([1, 2, 3])
// => 3
exports.object = size({ a: 1, b: 2 })
// => 2
exports.string = size('pebbles')
// => 7
================================================
FILE: src/content/lodash/collection/some/lodash.js
================================================
// https://lodash.com/docs/#some
import { some } from 'lodash'
const isEven = n => n % 2 === 0
module.exports = some([3, 4, 5], isEven)
// => true
================================================
FILE: src/content/lodash/collection/some/notes.md
================================================
Checks if predicate returns truthy for any element of collection. Iteration is stopped once predicate returns truthy. The predicate is invoked with three arguments: (value, index|key, collection).
Resources: [Array#some](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/some)
================================================
FILE: src/content/lodash/collection/some/spec.js
================================================
const expected = true
const lodash = require('./lodash')
const plain = require('./vanilla')
test('some', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/collection/some/vanilla.js
================================================
const isEven = n => n % 2 === 0
module.exports = [3, 4, 5].some(isEven)
// => true
================================================
FILE: src/content/lodash/date/now/lodash.js
================================================
// https://lodash.com/docs/#now
import { now } from 'lodash'
module.exports = now()
// => # milliseconds elapsed since the Unix epoch
================================================
FILE: src/content/lodash/date/now/notes.md
================================================
Gets the timestamp of the number of milliseconds that have elapsed since the Unix epoch (1 January 1970 00:00:00 UTC).
Resources: [Date.now](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date/now)
================================================
FILE: src/content/lodash/date/now/spec.js
================================================
const lodash = require('./lodash')
const plain = require('./vanilla')
test('some', () => {
// eslint-disable-next-line no-restricted-globals
expect(isNaN(new Date(plain))).toEqual(false)
expect(new Date(plain).getTime()).toEqual(plain)
expect(plain - lodash).toEqual(0)
})
================================================
FILE: src/content/lodash/date/now/vanilla.js
================================================
module.exports = Date.now()
// => # milliseconds elapsed since the Unix epoch
================================================
FILE: src/content/lodash/function/after/lodash.js
================================================
// https://lodash.com/docs/#after
import { after } from 'lodash'
module.exports = (times, fn) => after(times, fn)
// => check the tests for more details
================================================
FILE: src/content/lodash/function/after/notes.md
================================================
The opposite of \_.before; this method creates a function that invokes func once it's called n or more times.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/after/spec.js
================================================
const fns = {
lodash: require('./lodash'),
plain: require('./vanilla'),
}
describe('after', () => {
Object.entries(fns).forEach(([key, method]) => {
describe(key, () => {
let fn
beforeEach(() => {
fn = jest.fn(a => a)
})
test('it should call the fn only from the nth invocation and subsequents', () => {
const befored = method(5, fn)
for (let i = 0; i < 100; i++) {
befored(i)
}
expect(fn).toBeCalledTimes(96)
})
})
})
})
================================================
FILE: src/content/lodash/function/after/vanilla.js
================================================
const after = (times, fn) => {
let counter = 0
return (...args) => {
counter++
if (counter >= times) {
return fn(...args)
}
}
}
module.exports = (times, fn) => after(times, fn)
================================================
FILE: src/content/lodash/function/ary/lodash.js
================================================
// https://lodash.com/docs/#ary
import { ary } from 'lodash'
module.exports = ['6', '8', '10'].map(ary(Number.parseInt, 1))
// => [6, 8, 10]
================================================
FILE: src/content/lodash/function/ary/notes.md
================================================
Creates a function that invokes func, with up to n arguments, ignoring any additional arguments.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/ary/spec.js
================================================
const expected = [6, 8, 10]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('ary', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/ary/vanilla.js
================================================
const ary =
(fn, arity) =>
(...args) =>
fn(...args.slice(0, arity))
module.exports = ['6', '8', '10'].map(ary(Number.parseInt, 1))
// => [6, 8, 10]
================================================
FILE: src/content/lodash/function/before/lodash.js
================================================
// https://lodash.com/docs/#before
import { before } from 'lodash'
module.exports = (times, fn) => before(times, fn)
// => check the tests for more details
================================================
FILE: src/content/lodash/function/before/notes.md
================================================
Creates a function that invokes func, with the this binding and arguments of the created function, while it's called less than n times. Subsequent calls to the created function return the result of the last func invocation.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/before/spec.js
================================================
const fns = {
lodash: require('./lodash'),
plain: require('./vanilla'),
}
describe('before', () => {
Object.entries(fns).forEach(([key, method]) => {
describe(key, () => {
let fn
beforeEach(() => {
fn = jest.fn(a => a)
})
test('it should call the fn only the first n-1 times and then return the result of the last operation', () => {
const befored = method(3, fn)
let res
for (let i = 0; i < 100; i++) {
res = befored(i)
}
expect(fn).toBeCalledTimes(2)
expect(res).toBe(1)
})
})
})
})
================================================
FILE: src/content/lodash/function/before/vanilla.js
================================================
const before = (times, fn) => {
let counter = 0
let res
return (...args) => {
counter++
if (counter < times) {
res = fn(...args)
return res
} else {
return res
}
}
}
module.exports = (times, fn) => before(times, fn)
================================================
FILE: src/content/lodash/function/bind/lodash.js
================================================
// https://lodash.com/docs/#bind
import { bind } from 'lodash'
function greet(greeting, punctuation) {
return greeting + ' ' + this.user + punctuation
}
var object = { user: 'fred' }
var bound = bind(greet, object, 'hi')
module.exports = bound('!')
// => 'hi fred!'
================================================
FILE: src/content/lodash/function/bind/notes.md
================================================
Creates a function that invokes func with the this binding of thisArg and partials prepended to the arguments it receives.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Function#bind](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Function/bind)
================================================
FILE: src/content/lodash/function/bind/spec.js
================================================
const expected = 'hi fred!'
const lodash = require('./lodash')
const plain = require('./vanilla')
test('bind', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/bind/vanilla.js
================================================
const bind = (fn, ctx, ...boundArgs) => fn.bind(ctx, ...boundArgs)
function greet(greeting, punctuation) {
return greeting + ' ' + this.user + punctuation
}
var object = { user: 'fred' }
var bound = bind(greet, object, 'hi')
module.exports = bound('!')
// => 'hi fred!'
================================================
FILE: src/content/lodash/function/bindKey/lodash.js
================================================
// https://lodash.com/docs/#bindKey
import { bindKey } from 'lodash'
const object = {
'user': 'fred',
'greet': function (greeting, punctuation) {
return greeting + ' ' + this.user + punctuation
},
}
let bound = bindKey(object, 'greet', 'hi')
exports.first = bound('!')
// => 'hi fred!'
object.greet = function (greeting, punctuation) {
return greeting + 'ya ' + this.user + punctuation
}
exports.second = bound('!')
// => 'hiya fred!'
================================================
FILE: src/content/lodash/function/bindKey/notes.md
================================================
Creates a function that invokes the method at object[key] with partials prepended to the arguments it receives.
This method differs from _.bind by allowing bound functions to reference methods that may be redefined or don't yet exist. See Peter Michaux's article for more details.
The _.bindKey.placeholder value, which defaults to \_ in monolithic builds, may be used as a placeholder for partially applied arguments.
Resources: [Spread](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/bindKey/spec.js
================================================
const expected = {
first: 'hi fred!',
second: 'hiya fred!',
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('bindKey', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/bindKey/vanilla.js
================================================
const bindKey =
(obj, method, ...args) =>
(...bound) =>
obj[method](...args, ...bound)
const object = {
'user': 'fred',
'greet': function (greeting, punctuation) {
return greeting + ' ' + this.user + punctuation
},
}
let bound = bindKey(object, 'greet', 'hi')
exports.first = bound('!')
// => 'hi fred!'
object.greet = function (greeting, punctuation) {
return greeting + 'ya ' + this.user + punctuation
}
exports.second = bound('!')
// => 'hiya fred!'
================================================
FILE: src/content/lodash/function/curry/lodash.js
================================================
// https://lodash.com/docs/#curry
import { curry } from 'lodash'
const abc = (a, b, c) => [a, b, c]
const curried = curry(abc)
exports.curry = curried(1)(2)(3)
// => [1, 2, 3]
exports.moreargs = curried(1, 2)(3)
// => [1, 2, 3]
exports.allargs = curried(1, 2, 3)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/function/curry/notes.md
================================================
Creates a function that accepts arguments of func and either invokes func returning its result, if at least arity number of arguments have been provided, or returns a function that accepts the remaining func arguments, and so on. The arity of func may be specified if func.length is not sufficient.
The _.curry.placeholder value, which defaults to _ in monolithic builds, may be used as a placeholder for provided arguments.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [learn-js](https://github.com/learn-javascript-courses/es6-curry)
================================================
FILE: src/content/lodash/function/curry/spec.js
================================================
const expected = {
curry: [1, 2, 3],
moreargs: [1, 2, 3],
allargs: [1, 2, 3],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('curry', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/curry/vanilla.js
================================================
const curry = func => {
// define the number of expected arguments
const expectedArgs = func.length
const curried = (...args) => {
// if enough arugments has been passed return the
// result of the function execution, otherwise
// continue adding arguments to the list
return args.length >= expectedArgs
? func(...args)
: (...args2) => curried(...args.concat(args2))
}
return curried
}
const abc = (a, b, c) => [a, b, c]
const curried = curry(abc)
exports.curry = curried(1)(2)(3)
// => [1, 2, 3]
exports.moreargs = curried(1, 2)(3)
// => [1, 2, 3]
exports.allargs = curried(1, 2, 3)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/function/curryRight/lodash.js
================================================
// https://lodash.com/docs/#curryRight
import { curryRight } from 'lodash'
const abc = (a, b, c) => [a, b, c]
const curried = curryRight(abc)
exports.curry = curried(3)(2)(1)
// => [1, 2, 3]
exports.moreargs = curried(2, 3)(1)
// => [1, 2, 3]
exports.allargs = curried(1, 2, 3)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/function/curryRight/notes.md
================================================
This method is like _.curry except that arguments are applied to func in the manner of _.partialRight instead of _.partial.
The _.curryRight.placeholder value, which defaults to \_ in monolithic builds, may be used as a placeholder for provided arguments.
Resources: [learn-js](https://github.com/learn-javascript-courses/es6-curry)
================================================
FILE: src/content/lodash/function/curryRight/spec.js
================================================
const expected = {
curry: [1, 2, 3],
moreargs: [1, 2, 3],
allargs: [1, 2, 3],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('curry', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/curryRight/vanilla.js
================================================
// the only difference from the curry method
// implementation is how arguments gets concatenated
const curryRight = func => {
const expectedArgs = func.length
const curried = (...args) => {
return args.length >= expectedArgs
? func(...args)
: (...args2) => curried(...args2.concat(args))
}
return curried
}
const abc = (a, b, c) => [a, b, c]
const curried = curryRight(abc)
exports.curry = curried(3)(2)(1)
// => [1, 2, 3]
exports.moreargs = curried(2, 3)(1)
// => [1, 2, 3]
exports.allargs = curried(1, 2, 3)
// => [1, 2, 3]
================================================
FILE: src/content/lodash/function/debounce/lodash.js
================================================
// https://lodash.com/docs/#debounce
import { debounce } from 'lodash'
module.exports = (...args) => debounce(...args)
// => check the tests for more details
================================================
FILE: src/content/lodash/function/debounce/notes.md
================================================
Creates a debounced function that delays invoking func until after wait milliseconds have elapsed since the last time the debounced function was invoked.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Debounce vs Throttle demo](http://demo.nimius.net/debounce_throttle/)
================================================
FILE: src/content/lodash/function/debounce/spec.js
================================================
const fns = {
lodash: require('./lodash'),
plain: require('./vanilla'),
}
jest.useFakeTimers()
describe('debounce', () => {
Object.entries(fns).forEach(([key, debounce]) => {
describe(key, () => {
let fn
beforeEach(() => {
fn = jest.fn()
})
test('it should call the debounced fn once at the end of the quiet time', () => {
const debounced = debounce(fn, 1000)
for (let i = 0; i < 100; i++) {
debounced(i)
}
jest.advanceTimersByTime(1001)
expect(fn).toBeCalledTimes(1)
expect(fn).toBeCalledWith(99)
})
test('it should call the debounced fn once at the end of the quiet time', () => {
const debounced = debounce(fn, 1000)
for (let i = 0; i < 100; i++) {
debounced(i)
jest.advanceTimersByTime(999)
}
jest.advanceTimersByTime(1000)
expect(fn).toBeCalledTimes(1)
expect(fn).toBeCalledWith(99)
})
test("with a leading invocation, it should call the debounced fn once, if the time doesn't pass", () => {
const debounced = debounce(fn, 1000, { leading: true })
for (let i = 0; i < 100; i++) {
debounced(i)
}
jest.advanceTimersByTime(999)
expect(fn).toBeCalledTimes(1)
expect(fn).toBeCalledWith(0)
})
test('with a leading invocation, it should call the debounced fn twice (at the beginning and at the end)', () => {
const debounced = debounce(fn, 1000, { leading: true })
for (let i = 0; i < 100; i++) {
debounced(i)
}
jest.advanceTimersByTime(1500)
expect(fn).toBeCalledTimes(2)
expect(fn).toBeCalledWith(0)
expect(fn).toBeCalledWith(99)
})
test('it should call the debounced fn once with leading option if it was called once', () => {
const debounced = debounce(fn, 1000, { leading: true })
debounced();
jest.advanceTimersByTime(1001)
expect(fn).toBeCalledTimes(1)
})
})
})
})
================================================
FILE: src/content/lodash/function/debounce/vanilla.js
================================================
const debounce = (func, delay, { leading } = {}) => {
let timerId
let shouldInvoke
return (...args) => {
shouldInvoke = true
if (!timerId && leading) {
func(...args)
shouldInvoke = false
}
clearTimeout(timerId)
timerId = setTimeout(() => shouldInvoke && func(...args), delay)
}
}
module.exports = (...args) => debounce(...args)
================================================
FILE: src/content/lodash/function/delay/lodash.js
================================================
// https://lodash.com/docs/#delay
import { delay } from 'lodash'
module.exports = fn => delay(fn, 1000, 'later')
// => check the tests for more details
================================================
FILE: src/content/lodash/function/delay/notes.md
================================================
Invokes func after wait milliseconds. Any additional arguments are provided to func when it's invoked.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/delay/spec.js
================================================
const fns = {
lodash: require('./lodash'),
plain: require('./vanilla'),
}
jest.useFakeTimers()
describe('delay', () => {
Object.entries(fns).forEach(([key, delay]) => {
describe(key, () => {
let fn
beforeEach(() => {
fn = jest.fn()
})
test("it should not call the delayed function if the time didn't pass", () => {
delay(fn)
expect(fn).toBeCalledTimes(0)
})
test('it should call the delayed function if the time passed', () => {
delay(fn)
jest.advanceTimersByTime(1001)
expect(fn).toBeCalledTimes(1)
expect(fn).toBeCalledWith('later')
})
})
})
})
================================================
FILE: src/content/lodash/function/delay/vanilla.js
================================================
const delay = (fn, timer, ...args) => setTimeout(() => fn(...args), timer)
module.exports = fn => delay(fn, 1000, 'later')
================================================
FILE: src/content/lodash/function/flip/lodash.js
================================================
// https://lodash.com/docs/#flip
import { flip } from 'lodash'
const flipped = flip((...args) => args)
module.exports = flipped('a', 'b', 'c', 'd')
// => ['d', 'c', 'b', 'a']
================================================
FILE: src/content/lodash/function/flip/notes.md
================================================
Creates a function that invokes func with arguments reversed.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/flip/spec.js
================================================
const expected = ['d', 'c', 'b', 'a']
const lodash = require('./lodash')
const plain = require('./vanilla')
test('flip', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/flip/vanilla.js
================================================
const flip =
func =>
(...args) =>
func(...args.reverse())
const flipped = flip((...args) => args)
module.exports = flipped('a', 'b', 'c', 'd')
// => ['d', 'c', 'b', 'a']
================================================
FILE: src/content/lodash/function/negate/lodash.js
================================================
// https://lodash.com/docs/#negate
import { negate } from 'lodash'
const isEven = n => n % 2 === 0
module.exports = [1, 2, 3, 4, 5, 6].filter(negate(isEven))
// => [1, 3, 5]
================================================
FILE: src/content/lodash/function/negate/notes.md
================================================
Creates a function that negates the result of the predicate func. The func predicate is invoked with the this binding and arguments of the created function.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/negate/spec.js
================================================
const expected = [1, 3, 5]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('negate', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/negate/vanilla.js
================================================
const negate =
func =>
(...args) =>
!func(...args)
const isEven = n => n % 2 === 0
module.exports = [1, 2, 3, 4, 5, 6].filter(negate(isEven))
// => [1, 3, 5]
================================================
FILE: src/content/lodash/function/once/lodash.js
================================================
// https://lodash.com/docs/#once
import { once } from 'lodash'
module.exports = fn => once(fn)
// => check the tests for more details
================================================
FILE: src/content/lodash/function/once/notes.md
================================================
Creates a function that is restricted to invoking func once. Repeat calls to the function return the value of the first invocation.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/once/spec.js
================================================
const fns = {
lodash: require('./lodash'),
plain: require('./vanilla'),
}
describe('once', () => {
Object.entries(fns).forEach(([key, once]) => {
describe(key, () => {
let fn
beforeEach(() => {
fn = jest.fn(a => a)
})
test('it should call the function only once', () => {
const onlyOnce = once(fn)
let res
for (let i = 0; i < 100; i++) {
res = onlyOnce(i)
}
expect(fn).toBeCalledTimes(1)
expect(fn).toBeCalledWith(0)
expect(res).toBe(0)
})
})
})
})
================================================
FILE: src/content/lodash/function/once/vanilla.js
================================================
const once = fn => {
let called = false
let result
return (...args) => {
if (!called) {
result = fn(...args)
called = true
}
return result
}
}
module.exports = fn => once(fn)
================================================
FILE: src/content/lodash/function/overArgs/lodash.js
================================================
// https://lodash.com/docs/#overArgs
import { overArgs } from 'lodash'
function doubled(n) {
return n * 2
}
function square(n) {
return n * n
}
const func = overArgs(
function (x, y) {
return [x, y]
},
[square, doubled]
)
exports.example1 = func(9, 3)
// => [81, 6]
exports.example2 = func(10, 5)
// => [100, 10]
================================================
FILE: src/content/lodash/function/overArgs/notes.md
================================================
Creates a function that invokes func with its arguments transformed.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/map)
================================================
FILE: src/content/lodash/function/overArgs/spec.js
================================================
const expected = {
example1: [81, 6],
example2: [100, 10],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('overArgs', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/overArgs/vanilla.js
================================================
const overArgs =
(fn, ops) =>
(...args) => {
const mappedArgs = args.map((arg, i) => (ops[i] ? ops[i](arg) : arg))
return fn(...mappedArgs)
}
function doubled(n) {
return n * 2
}
function square(n) {
return n * n
}
const func = overArgs(
function (x, y) {
return [x, y]
},
[square, doubled]
)
exports.example1 = func(9, 3)
// => [81, 6]
exports.example2 = func(10, 5)
// => [100, 10]
================================================
FILE: src/content/lodash/function/partial/lodash.js
================================================
// https://lodash.com/docs/#partial
import { partial } from 'lodash'
const greet = (greeting, name) => `${greeting} ${name}`
const sayHelloTo = partial(greet, 'hello')
module.exports = sayHelloTo('fred')
// => 'hello fred'
================================================
FILE: src/content/lodash/function/partial/notes.md
================================================
Creates a function that invokes func with partials prepended to the arguments it receives.
================================================
FILE: src/content/lodash/function/partial/spec.js
================================================
const expected = 'hello fred'
const lodash = require('./lodash')
const plain = require('./vanilla')
test('partial', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/partial/vanilla.js
================================================
const partial =
(func, ...args) =>
(...furtherArgs) =>
func(...args, ...furtherArgs)
const greet = (greeting, name) => `${greeting} ${name}`
const sayHelloTo = partial(greet, 'hello')
module.exports = sayHelloTo('fred')
// => 'hello fred'
================================================
FILE: src/content/lodash/function/partialRight/lodash.js
================================================
// https://lodash.com/docs/#partialRight
import { partialRight } from 'lodash'
const greet = (greeting, name) => `${greeting} ${name}`
const greetFred = partialRight(greet, 'fred')
module.exports = greetFred('hi')
// => 'hi fred'
================================================
FILE: src/content/lodash/function/partialRight/notes.md
================================================
This method is like \_.partial except that partially applied arguments are appended to the arguments it receives.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/partialRight/spec.js
================================================
const expected = 'hi fred'
const lodash = require('./lodash')
const plain = require('./vanilla')
test('partialRight', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/partialRight/vanilla.js
================================================
const partialRight =
(func, ...cachedArgs) =>
(...args) =>
func(...args, ...cachedArgs)
const greet = (greeting, name) => `${greeting} ${name}`
const greetFred = partialRight(greet, 'fred')
module.exports = greetFred('hi')
// => 'hi fred'
================================================
FILE: src/content/lodash/function/rearg/lodash.js
================================================
// https://lodash.com/docs/#rearg
import { rearg } from 'lodash'
const rearged = rearg((a, b, c) => [a, b, c], [2, 0, 1])
module.exports = rearged('b', 'c', 'a')
// => ['a', 'b', 'c']
================================================
FILE: src/content/lodash/function/rearg/notes.md
================================================
Creates a function that invokes func with arguments arranged according to the specified indexes where the argument value at the first index is provided as the first argument, the argument value at the second index is provided as the second argument, and so on.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/rearg/spec.js
================================================
const expected = ['a', 'b', 'c']
const lodash = require('./lodash')
const plain = require('./vanilla')
test('rearg', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/rearg/vanilla.js
================================================
const rearg =
(func, order) =>
(...args) => {
const reargs = order.map(idx => args[idx])
return func(...reargs)
}
const rearged = rearg((a, b, c) => [a, b, c], [2, 0, 1])
module.exports = rearged('b', 'c', 'a')
// => ['a', 'b', 'c']
================================================
FILE: src/content/lodash/function/rest/lodash.js
================================================
// https://lodash.com/docs/#rest
import { rest } from 'lodash'
const say = rest(
(what, names) =>
what +
' ' +
names.slice(0, -1).join(', ') + // see _.initial
(names.length > 1 ? ', & ' : '') +
names[names.length - 1] // see _.last
)
module.exports = say('hello', 'fred', 'barney', 'pebbles')
// => 'hello fred, barney, & pebbles'
================================================
FILE: src/content/lodash/function/rest/notes.md
================================================
Creates a function that invokes func with the this binding of the created function and arguments from start and beyond provided as an array.
Note: This method is based on the rest parameter.
================================================
FILE: src/content/lodash/function/rest/spec.js
================================================
const expected = 'hello fred, barney, & pebbles'
const lodash = require('./lodash')
const plain = require('./vanilla')
test('rest', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/rest/vanilla.js
================================================
const rest =
func =>
(first, ...args) =>
func(first, args)
const say = rest(
(what, names) =>
what +
' ' +
names.slice(0, -1).join(', ') + // see _.initial
(names.length > 1 ? ', & ' : '') +
names[names.length - 1] // see _.last
)
module.exports = say('hello', 'fred', 'barney', 'pebbles')
// => 'hello fred, barney, & pebbles'
================================================
FILE: src/content/lodash/function/spread/lodash.js
================================================
// https://lodash.com/docs/#spread
import { spread } from 'lodash'
const say = spread(function (who, what) {
return who + ' says ' + what
})
exports.basic = say(['fred', 'hello'])
// => 'fred says hello'
const numbers = Promise.all([Promise.resolve(40), Promise.resolve(36)])
exports.promise = numbers.then(
spread(function (x, y) {
return x + y
})
)
// => a Promise of 76
================================================
FILE: src/content/lodash/function/spread/notes.md
================================================
Creates a function that invokes func with the this binding of the create function and an array of arguments much like Function#apply.
Note: This method is based on the spread operator.
Resources: [Spread](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/spread/spec.js
================================================
const expected = {
basic: 'fred says hello',
promise: 76,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
describe('spread', () => {
test('basic', () => {
expect(lodash.basic).toEqual(expected.basic)
expect(plain.basic).toEqual(lodash.basic)
})
test('promise', async () => {
const lodashRes = await lodash.promise
const plainRes = await plain.promise
expect(lodashRes).toEqual(expected.promise)
expect(plainRes).toEqual(lodashRes)
})
})
================================================
FILE: src/content/lodash/function/spread/vanilla.js
================================================
const spread = func => args => func(...args)
const say = spread(function (who, what) {
return who + ' says ' + what
})
exports.basic = say(['fred', 'hello'])
// => 'fred says hello'
const numbers = Promise.all([Promise.resolve(40), Promise.resolve(36)])
exports.promise = numbers.then(
spread(function (x, y) {
return x + y
})
)
// => a Promise of 76
================================================
FILE: src/content/lodash/function/unary/lodash.js
================================================
// https://lodash.com/docs/#unary
import { unary } from 'lodash'
module.exports = ['6', '8', '10'].map(unary(Number.parseInt))
// => [6, 8, 10]
================================================
FILE: src/content/lodash/function/unary/notes.md
================================================
Creates a function that accepts up to one argument, ignoring any additional arguments.
================================================
FILE: src/content/lodash/function/unary/spec.js
================================================
const expected = [6, 8, 10]
const lodash = require('./lodash')
const plain = require('./vanilla')
test('unary', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/unary/vanilla.js
================================================
const unary = fn => arg => fn(arg)
module.exports = ['6', '8', '10'].map(unary(Number.parseInt))
// => [6, 8, 10]
================================================
FILE: src/content/lodash/function/wrap/lodash.js
================================================
// https://lodash.com/docs/#wrap
import { wrap } from 'lodash'
const sum2 = wrap(2, (a, b, c) => {
return a + b + c
})
module.exports = sum2(1, 2)
// => 5
================================================
FILE: src/content/lodash/function/wrap/notes.md
================================================
Creates a function that provides value to wrapper as its first argument. Any additional arguments provided to the function are appended to those provided to the wrapper.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/function/wrap/spec.js
================================================
const expected = 5
const lodash = require('./lodash')
const plain = require('./vanilla')
test('wrap', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/function/wrap/vanilla.js
================================================
const wrap =
(value, func) =>
(...args) =>
func(value, ...args)
const sum2 = wrap(2, (a, b, c) => {
return a + b + c
})
module.exports = sum2(1, 2)
// => 5
================================================
FILE: src/content/lodash/lang/castArray/lodash.js
================================================
// https://lodash.com/docs/#castArray
import { castArray } from 'lodash'
exports.num = castArray(1)
// => [1]
exports.obj = castArray({ a: 1 })
// => [{ 'a': 1 }]
exports.str = castArray('abc')
// => ['abc']
exports.null = castArray(null)
// => [null]
exports.undefined = castArray(undefined)
// => [undefined]
exports.empty = castArray()
// => []
const array = [1, 2, 3]
exports.arrayEquality = castArray(array) === array
// => true
================================================
FILE: src/content/lodash/lang/castArray/notes.md
================================================
Casts value as an array if it's not one.
Resources: [instanceof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/instanceof) [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/lang/castArray/spec.js
================================================
const expected = {
num: [1],
obj: [{ a: 1 }],
str: ['abc'],
null: [null],
undefined: [undefined],
empty: [],
arrayEquality: true,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('castArray', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/castArray/vanilla.js
================================================
const castArray = (...args) => (args[0] instanceof Array ? args[0] : args)
exports.num = castArray(1)
// => [1]
exports.obj = castArray({ a: 1 })
// => [{ 'a': 1 }]
exports.str = castArray('abc')
// => ['abc']
exports.null = castArray(null)
// => [null]
exports.undefined = castArray(undefined)
// => [undefined]
exports.empty = castArray()
// => []
const array = [1, 2, 3]
exports.arrayEquality = castArray(array) === array
// => true
================================================
FILE: src/content/lodash/lang/cloneDeep/jest.fix.js
================================================
/* istanbul ignore file */
import JSDOMEnvironment from 'jest-environment-jsdom'
// https://github.com/facebook/jest/blob/v29.4.3/website/versioned_docs/version-29.4/Configuration.md#testenvironment-string
export default class FixJSDOMEnvironment extends JSDOMEnvironment {
constructor(...args) {
super(...args)
// FIXME https://github.com/jsdom/jsdom/issues/3363
this.global.structuredClone = structuredClone
}
}
================================================
FILE: src/content/lodash/lang/cloneDeep/lodash.js
================================================
// https://lodash.com/docs/#cloneDeep
import { cloneDeep } from 'lodash'
var objects = [{ 'a': 1 }, { 'b': 2 }]
var deep = cloneDeep(objects)
module.exports = deep[0] === objects[0]
// => false
================================================
FILE: src/content/lodash/lang/cloneDeep/notes.md
================================================
This method is like \_.clone except that it recursively clones value.
Resources: [structuredClone](https://developer.mozilla.org/docs/Web/API/structuredClone)
================================================
FILE: src/content/lodash/lang/cloneDeep/spec.js
================================================
/**
* @jest-environment ./src/content/lodash/lang/cloneDeep/jest.fix.js
*/
const expected = false
const lodash = require('./lodash')
const plain = require('./vanilla')
test('cloneDeep', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/cloneDeep/vanilla.js
================================================
const cloneDeep = object => structuredClone(object)
var objects = [{ 'a': 1 }, { 'b': 2 }]
var deep = cloneDeep(objects)
module.exports = deep[0] === objects[0]
// => false
================================================
FILE: src/content/lodash/lang/conformsTo/lodash.js
================================================
// https://lodash.com/docs/#conformsTo
import { conformsTo } from 'lodash'
const object = { a: 1, b: 2 }
exports.scenario1 = conformsTo(object, {
b: n => n > 1,
})
// => true
exports.scenario2 = conformsTo(object, {
b: n => n > 2,
})
// => false
================================================
FILE: src/content/lodash/lang/conformsTo/notes.md
================================================
Checks if object conforms to source by invoking the predicate properties of source with the corresponding property values of object.
Resources: [Object.keys](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/keys) [Array#every](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/every)
================================================
FILE: src/content/lodash/lang/conformsTo/spec.js
================================================
const expected = {
scenario1: true,
scenario2: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('conformsTo', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/conformsTo/vanilla.js
================================================
const conformsTo = (obj, ruleSet) =>
Object.keys(ruleSet).every(key => ruleSet[key](obj[key]))
const object = { a: 1, b: 2 }
exports.scenario1 = conformsTo(object, {
b: n => n > 1,
})
// => true
exports.scenario2 = conformsTo(object, {
b: n => n > 2,
})
// => false
================================================
FILE: src/content/lodash/lang/gt/lodash.js
================================================
// https://lodash.com/docs/#gt
import { gt } from 'lodash'
exports.greaterThan = gt(3, 1)
// => true
exports.equalTo = gt(3, 3)
// => false
exports.lessThan = gt(1, 3)
// => false
================================================
FILE: src/content/lodash/lang/gt/notes.md
================================================
Checks if value is greater than other.
Resources: [Comparison Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Comparison_Operators)
================================================
FILE: src/content/lodash/lang/gt/spec.js
================================================
const expected = {
greaterThan: true,
equalTo: false,
lessThan: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('gt', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/gt/vanilla.js
================================================
const gt = (a, b) => a > b
exports.greaterThan = gt(3, 1)
// => true
exports.equalTo = gt(3, 3)
// => false
exports.lessThan = gt(1, 3)
// => false
================================================
FILE: src/content/lodash/lang/gte/lodash.js
================================================
// https://lodash.com/docs/#gte
import { gte } from 'lodash'
exports.greaterThan = gte(3, 1)
// => true
exports.equalTo = gte(3, 3)
// => true
exports.lessThan = gte(1, 3)
// => false
================================================
FILE: src/content/lodash/lang/gte/notes.md
================================================
Checks if value is greater than or equal to other.
Resources: [Comparison Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Comparison_Operators)
================================================
FILE: src/content/lodash/lang/gte/spec.js
================================================
const expected = {
greaterThan: true,
equalTo: true,
lessThan: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('gte', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/gte/vanilla.js
================================================
const gte = (a, b) => a >= b
exports.greaterThan = gte(3, 1)
// => true
exports.equalTo = gte(3, 3)
// => true
exports.lessThan = gte(1, 3)
// => false
================================================
FILE: src/content/lodash/lang/isArray/lodash.js
================================================
// https://lodash.com/docs/#isArray
import { isArray } from 'lodash'
exports.array = isArray([1, 2, 3])
// => true
exports.dom_body_children = isArray(document.body.children)
// => false
exports.string = isArray('abc')
// => false
================================================
FILE: src/content/lodash/lang/isArray/notes.md
================================================
Checks if value is classified as an Array object.
Resources: [Array.isArray](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray)
================================================
FILE: src/content/lodash/lang/isArray/spec.js
================================================
const expected = {
array: true,
dom_body_children: false,
string: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isArray', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isArray/vanilla.js
================================================
exports.array = Array.isArray([1, 2, 3])
// => true
exports.dom_body_children = Array.isArray(document.body.children)
// => false
exports.string = Array.isArray('abc')
// => false
================================================
FILE: src/content/lodash/lang/isArrayBuffer/lodash.js
================================================
// https://lodash.com/docs/#isArrayBuffer
import { isArrayBuffer } from 'lodash'
exports.arrayBuffer = isArrayBuffer(new ArrayBuffer(2))
// => true
exports.array = isArrayBuffer(new Array(2))
// => false
================================================
FILE: src/content/lodash/lang/isArrayBuffer/notes.md
================================================
Checks if value is an instance of ArrayBuffer.
Resources: [Node.js](https://nodejs.org/api/util.html#utiltypesisarraybuffervalue) [node-util](https://github.com/browserify/node-util/)
================================================
FILE: src/content/lodash/lang/isArrayBuffer/spec.js
================================================
const expected = {
arrayBuffer: true,
array: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isArrayBuffer', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isArrayBuffer/vanilla.js
================================================
// Since Node.js v10+, it's available in the util library
// https://nodejs.org/api/util.html##utiltypesisarraybuffervalue
//
// This implementation is a simplified version of the one found
// in the polyfill module node-util (and it doesn't support IE)
const isArrayBuffer = value => value.toString() === '[object ArrayBuffer]'
exports.arrayBuffer = isArrayBuffer(new ArrayBuffer(2))
// => true
exports.array = isArrayBuffer(new Array(2))
// => false
================================================
FILE: src/content/lodash/lang/isArrayLike/lodash.js
================================================
// https://lodash.com/docs/#isArrayLike
import { isArrayLike } from 'lodash'
exports.array = isArrayLike([1, 2, 3])
// => true
exports.arrayLike = isArrayLike(document.body.children)
// => true
exports.string = isArrayLike('abc')
// => true
exports.obj = isArrayLike({ a: 1 })
// => false
exports.funct = isArrayLike(() => {})
// => false
================================================
FILE: src/content/lodash/lang/isArrayLike/notes.md
================================================
Checks if value is array-like. A value is considered array-like if it's not a function and has a value.length that's an integer greater than or equal to 0 and less than or equal to Number.MAX_SAFE_INTEGER.
Resources: [Number.MAX_SAFE_INTEGER](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER) [Optional Chaining](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Optional_chaining)
================================================
FILE: src/content/lodash/lang/isArrayLike/spec.js
================================================
const expected = {
array: true,
arrayLike: true,
string: true,
obj: false,
funct: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isArrayLike', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isArrayLike/vanilla.js
================================================
const isArrayLike = a =>
typeof a !== 'function' &&
a?.length >= 0 &&
a?.length <= Number.MAX_SAFE_INTEGER
exports.array = isArrayLike([1, 2, 3])
// => true
exports.arrayLike = isArrayLike(document.body.children)
// => true
exports.string = isArrayLike('abc')
// => true
exports.obj = isArrayLike({ a: 1 })
// => false
exports.funct = isArrayLike(() => {})
// => false
================================================
FILE: src/content/lodash/lang/isBoolean/lodash.js
================================================
// https://lodash.com/docs/#isBoolean
import { isBoolean } from 'lodash'
exports.true = isBoolean(false)
// => true
exports.false = isBoolean(null)
// => false
================================================
FILE: src/content/lodash/lang/isBoolean/notes.md
================================================
Checks if value is classified as a boolean primitive or object.
================================================
FILE: src/content/lodash/lang/isBoolean/spec.js
================================================
const expected = {
true: true,
false: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isBoolean', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isBoolean/vanilla.js
================================================
const isBoolean = arg => arg === !!arg
exports.true = isBoolean(false)
// => true
exports.false = isBoolean(null)
// => false
================================================
FILE: src/content/lodash/lang/isDate/.eslintrc
================================================
{
"rules": {
"no-restricted-globals": 0
}
}
================================================
FILE: src/content/lodash/lang/isDate/lodash.js
================================================
// https://lodash.com/docs/#isDate
import { isDate } from 'lodash'
exports.true = isDate(new Date())
// => true
exports.false = isDate('Mon April 23 2012')
// => false
================================================
FILE: src/content/lodash/lang/isDate/notes.md
================================================
Checks if value is classified as a Date object.
Resources: [instanceof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/instanceof)
================================================
FILE: src/content/lodash/lang/isDate/spec.js
================================================
const expected = {
true: true,
false: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isDate', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isDate/vanilla.js
================================================
const isDate = d => d instanceof Date && !isNaN(d)
exports.true = isDate(new Date())
// => true
exports.false = isDate('Mon April 23 2012')
// => false
================================================
FILE: src/content/lodash/lang/isEmpty/lodash.js
================================================
// https://lodash.com/docs/#isEmpty
import { isEmpty } from 'lodash'
exports.null = isEmpty(null)
// => true
exports.boolean = isEmpty(true)
// => true
exports.number = isEmpty(1)
// => true
exports.string = isEmpty('not empty')
// => false
exports.set = isEmpty(new Set([1, 2, 3]))
// => true
exports.map = isEmpty(new Map([['a', 1]]))
// => false
exports.array = isEmpty([1, 2, 3])
// => false
exports.object = isEmpty({ 'a': 1 })
// => false
exports.emptyArray = isEmpty([])
// => true
exports.emptyString = isEmpty('')
// => true
exports.emptySet = isEmpty(new Set())
// => true
exports.emptyMap = isEmpty(new Map())
// => true
================================================
FILE: src/content/lodash/lang/isEmpty/notes.md
================================================
Checks if value is an empty object, collection, map, or set.
Objects are considered empty if they have no own enumerable string keyed properties.
Array-like values such as arguments objects, arrays, buffers, strings, or jQuery-like collections are considered empty if they have a length of 0. Similarly, maps and sets are considered empty if they have a size of 0.
Resources: [Object.entries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries) [Set#size](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set/size) [Optional Chaining](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Optional_chaining)
================================================
FILE: src/content/lodash/lang/isEmpty/spec.js
================================================
const expected = {
array: false,
emptyArray: true,
emptyMap: true,
emptySet: true,
emptyString: true,
map: false,
null: true,
number: true,
object: false,
boolean: true,
set: false,
string: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isEmpty', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isEmpty/vanilla.js
================================================
const isEmpty = obj => {
if (obj?.length || obj?.size) return false
if (typeof obj !== 'object') return true
for (const key in obj) if (Object.hasOwn(obj, key)) return false
return true
}
exports.null = isEmpty(null)
// => true
exports.boolean = isEmpty(true)
// => true
exports.number = isEmpty(1)
// => true
exports.string = isEmpty('not empty')
// => false
exports.set = isEmpty(new Set([1, 2, 3]))
// => false
exports.map = isEmpty(new Map([['a', 1]]))
// => false
exports.array = isEmpty([1, 2, 3])
// => false
exports.object = isEmpty({ 'a': 1 })
// => false
exports.emptyArray = isEmpty([])
// => true
exports.emptyString = isEmpty('')
// => true
exports.emptySet = isEmpty(new Set())
// => true
exports.emptyMap = isEmpty(new Map())
// => true
================================================
FILE: src/content/lodash/lang/isError/lodash.js
================================================
// https://lodash.com/docs/#isError
import { isError } from 'lodash'
exports.error = isError(new Error())
// => true
exports.notError = isError(Error)
// => false
================================================
FILE: src/content/lodash/lang/isError/notes.md
================================================
Checks if value is an Error, EvalError, RangeError, ReferenceError, SyntaxError, TypeError, or URIError object.
Resources: [instanceof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/instanceof)
================================================
FILE: src/content/lodash/lang/isError/spec.js
================================================
const expected = {
error: true,
notError: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isError', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isError/vanilla.js
================================================
const isError = err => err instanceof Error
exports.error = isError(new Error())
// => true
exports.notError = isError(Error)
// => false
================================================
FILE: src/content/lodash/lang/isFinite/lodash.js
================================================
// https://lodash.com/docs/#isFinite
import { isFinite } from 'lodash'
exports.integer = isFinite(3)
// => true
exports.lowerBound = isFinite(Number.MIN_VALUE)
// => true
exports.infinite = isFinite(Infinity)
// => false
exports.stringNumber = isFinite('3')
// => false
================================================
FILE: src/content/lodash/lang/isFinite/notes.md
================================================
Checks if value is a finite primitive number.
Resources: [Number.isFinite](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isFinite)
================================================
FILE: src/content/lodash/lang/isFinite/spec.js
================================================
const expected = {
integer: true,
lowerBound: true,
infinite: false,
stringNumber: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isFinite', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isFinite/vanilla.js
================================================
exports.integer = Number.isFinite(3)
// => true
exports.lowerBound = Number.isFinite(Number.MIN_VALUE)
// => true
exports.infinite = Number.isFinite(Infinity)
// => false
exports.stringNumber = Number.isFinite('3')
// => false
================================================
FILE: src/content/lodash/lang/isFunction/lodash.js
================================================
// https://lodash.com/docs/#isFunction
import { isFunction } from 'lodash'
exports.func = isFunction(function () {})
// => true
exports.arrowFunc = isFunction(() => {})
// => true
exports.class = isFunction(class NotAFunction {})
// => true
exports.reg = isFunction(/abc/)
// => false
================================================
FILE: src/content/lodash/lang/isFunction/notes.md
================================================
Checks if value is classified as a Function object.
Resources: [typeof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/typeof)
================================================
FILE: src/content/lodash/lang/isFunction/spec.js
================================================
const expected = {
func: true,
arrowFunc: true,
class: true,
reg: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isFunction', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isFunction/vanilla.js
================================================
const isFunction = val => typeof val === 'function'
exports.func = isFunction(function () {})
// => true
exports.arrowFunc = isFunction(() => {})
// => true
exports.class = isFunction(class NotAFunction {})
// => false
exports.reg = isFunction(/abc/)
// => false
================================================
FILE: src/content/lodash/lang/isInteger/lodash.js
================================================
// https://lodash.com/docs/#isInteger
import { isInteger } from 'lodash'
exports.integer = isInteger(3)
// => true
exports.lowerBound = isInteger(Number.MIN_VALUE)
// => false
exports.infinite = isInteger(Infinity)
// => false
exports.stringNumber = isInteger('3')
// => false
================================================
FILE: src/content/lodash/lang/isInteger/notes.md
================================================
Checks if value is an integer.
Resources: [Number.isInteger](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isInteger)
================================================
FILE: src/content/lodash/lang/isInteger/spec.js
================================================
const expected = {
integer: true,
lowerBound: false,
infinite: false,
stringNumber: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isInteger', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isInteger/vanilla.js
================================================
exports.integer = Number.isInteger(3)
// => true
exports.lowerBound = Number.isInteger(Number.MIN_VALUE)
// => false
exports.infinite = Number.isInteger(Infinity)
// => false
exports.stringNumber = Number.isInteger('3')
// => false
================================================
FILE: src/content/lodash/lang/isMap/lodash.js
================================================
// https://lodash.com/docs/#isMap
import { isMap } from 'lodash'
exports.mapValue = isMap(new Map())
// => true
exports.weakMapValue = isMap(new WeakMap())
// => false
================================================
FILE: src/content/lodash/lang/isMap/notes.md
================================================
Checks if value is classified as a Map object.
================================================
FILE: src/content/lodash/lang/isMap/spec.js
================================================
const expected = {
mapValue: true,
weakMapValue: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isMap', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isMap/vanilla.js
================================================
// Since Node.js v10+, it's available in the util library
// https://nodejs.org/api/util.html##util_util_types_ismap_value
//
// This implementation is a simplified version of the one found
// in the polyfill module node-util (and it doesn't support IE)
const isMap = value => value.toString() === '[object Map]'
exports.mapValue = isMap(new Map())
// => true
exports.weakMapValue = isMap(new WeakMap())
// => false
================================================
FILE: src/content/lodash/lang/isMatch/lodash.js
================================================
// https://lodash.com/docs/#isMatch
import { isMatch } from 'lodash'
const object = { 'a': 1, 'b': 2, c: { a: 2 }, d: [1, 2, 3], e: {} }
exports.match = isMatch(object, { 'b': 2 })
// => true
exports.noMatch = isMatch(object, { 'b': 1 })
// => false
exports.matchNested = isMatch(object, { 'c': { a: 2 } })
// => true
exports.noMatchNested = isMatch(object, { 'c': { a: 3 } })
// => false
exports.matchArray = isMatch(object, { 'd': [1, 2, 3] })
// => true
exports.matchPartialArray = isMatch(object, { 'd': [2] })
// => true
exports.noMatchArray = isMatch(object, { 'd': 2 })
// => false
exports.empty = isMatch(object, { 'e': {} })
// => true
================================================
FILE: src/content/lodash/lang/isMatch/notes.md
================================================
Performs a partial deep comparison between object and source to determine if object contains equivalent property values.
Resources: [Array.isArray](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray) [Array#every](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/every) [Array#includes](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/includes)
================================================
FILE: src/content/lodash/lang/isMatch/spec.js
================================================
const expected = {
match: true,
noMatch: false,
matchNested: true,
noMatchNested: false,
matchArray: true,
matchPartialArray: true,
noMatchArray: false,
empty: true,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isMatch', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isMatch/vanilla.js
================================================
const isMatch = (object, source) => {
for (let key in source) {
// For arrays we look for partial matches
if (Array.isArray(source[key]) && Array.isArray(object[key])) {
return source[key].every(v => object[key].includes(v))
}
// For any other data type we look for equality of the values
return typeof source[key] === 'object'
? isMatch(object[key], source[key])
: object[key] === source[key]
}
// This should catch emtpy structures
return JSON.stringify(object) === JSON.stringify(source)
}
const object = { 'a': 1, 'b': 2, c: { a: 2 }, d: [1, 2, 3], e: {} }
exports.match = isMatch(object, { 'b': 2 })
// => true
exports.noMatch = isMatch(object, { 'b': 1 })
// => false
exports.matchNested = isMatch(object, { 'c': { a: 2 } })
// => true
exports.noMatchNested = isMatch(object, { 'c': { a: 3 } })
// => false
exports.matchArray = isMatch(object, { 'd': [1, 2, 3] })
// => true
exports.matchPartialArray = isMatch(object, { 'd': [2] })
// => true
exports.noMatchArray = isMatch(object, { 'd': 2 })
// => false
exports.empty = isMatch(object, { 'e': {} })
// => true
================================================
FILE: src/content/lodash/lang/isNaN/lodash.js
================================================
// https://lodash.com/docs/#isNaN
import { isNaN } from 'lodash'
exports.NaN = isNaN(NaN)
// => true
exports.NumberNaN = isNaN(Number(NaN))
// => true
exports.undef = isNaN(undefined)
// => false
================================================
FILE: src/content/lodash/lang/isNaN/notes.md
================================================
Checks if value is NaN.
Resources: [Number.isNaN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isNaN)
================================================
FILE: src/content/lodash/lang/isNaN/spec.js
================================================
const expected = {
NaN: true,
NumberNaN: true,
undef: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isNaN', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isNaN/vanilla.js
================================================
exports.NaN = Number.isNaN(NaN)
// => true
exports.NumberNaN = Number.isNaN(Number(NaN))
// => true
exports.undef = Number.isNaN(undefined)
// => false
================================================
FILE: src/content/lodash/lang/isNil/lodash.js
================================================
// https://lodash.com/docs/#isNil
import { isNil } from 'lodash'
exports.nullVal = isNil(null)
// => true
exports.undefVal = isNil(undefined)
// => true
exports.nanVal = isNil(NaN)
// => false
================================================
FILE: src/content/lodash/lang/isNil/notes.md
================================================
Checks if value is null or undefined.
Resources: [Comparison Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Comparison_Operators)
================================================
FILE: src/content/lodash/lang/isNil/spec.js
================================================
const expected = {
nullVal: true,
undefVal: true,
nanVal: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isNil', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isNil/vanilla.js
================================================
const isNil = val => val == null
exports.nullVal = isNil(null)
// => true
exports.undefVal = isNil(undefined)
// => true
exports.nanVal = isNil(NaN)
// => false
================================================
FILE: src/content/lodash/lang/isNull/lodash.js
================================================
// https://lodash.com/docs/#isNull
import { isNull } from 'lodash'
exports.nullVal = isNull(null)
// => true
exports.undefVal = isNull(undefined)
// => false
================================================
FILE: src/content/lodash/lang/isNull/notes.md
================================================
Checks if value is null.
Resources: [Equality comparisons](https://developer.mozilla.org/docs/Web/JavaScript/Equality_comparisons_and_sameness)
================================================
FILE: src/content/lodash/lang/isNull/spec.js
================================================
const expected = {
nullVal: true,
undefVal: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isNull', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isNull/vanilla.js
================================================
const isNull = val => val === null
exports.nullVal = isNull(null)
// => true
exports.undefVal = isNull(undefined)
// => false
================================================
FILE: src/content/lodash/lang/isNumber/lodash.js
================================================
// https://lodash.com/docs/#isNumber
import { isNumber } from 'lodash'
exports.number = isNumber(3)
// => true
exports.minValue = isNumber(Number.MIN_VALUE)
// => true
exports.infinity = isNumber(Infinity)
// => true
exports.string = isNumber('3')
// => false
================================================
FILE: src/content/lodash/lang/isNumber/notes.md
================================================
Checks if value is classified as a Number primitive or object.
Resources: [typeof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/typeof)
================================================
FILE: src/content/lodash/lang/isNumber/spec.js
================================================
const expected = {
number: true,
minValue: true,
infinity: true,
string: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isNumber', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isNumber/vanilla.js
================================================
const isNumber = a => typeof a === 'number'
exports.number = isNumber(3)
// => true
exports.minValue = isNumber(Number.MIN_VALUE)
// => true
exports.infinity = isNumber(Infinity)
// => true
exports.string = isNumber('3')
// => false
================================================
FILE: src/content/lodash/lang/isObject/lodash.js
================================================
// https://lodash.com/docs/#isObject
import { isObject } from 'lodash'
exports.object = isObject({})
// => true
exports.array = isObject([1, 2, 3])
// => true
exports.funct = isObject(() => {})
// => true
exports.null = isObject(null)
// => false
================================================
FILE: src/content/lodash/lang/isObject/notes.md
================================================
Checks if value is the language type of Object. (e.g. arrays, functions, objects, regexes, new Number(0), and new String(''))
Resources: [instanceof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/instanceof)
================================================
FILE: src/content/lodash/lang/isObject/spec.js
================================================
const expected = {
object: true,
array: true,
funct: true,
null: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isObject', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isObject/vanilla.js
================================================
const isObject = a => a instanceof Object
exports.object = isObject({})
// => true
exports.array = isObject([1, 2, 3])
// => true
exports.funct = isObject(() => {})
// => true
exports.null = isObject(null)
// => false
================================================
FILE: src/content/lodash/lang/isRegExp/lodash.js
================================================
// https://lodash.com/docs/#isRegExp
import { isRegExp } from 'lodash'
exports.regex = isRegExp(/abc/)
// => true
exports.notRegex = isRegExp('/abc/')
// => false
================================================
FILE: src/content/lodash/lang/isRegExp/notes.md
================================================
Checks if value is classified as a RegExp object.
Resources: [instanceof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/instanceof)
================================================
FILE: src/content/lodash/lang/isRegExp/spec.js
================================================
const expected = {
regex: true,
notRegex: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isRegExp', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isRegExp/vanilla.js
================================================
const isRegExp = obj => obj instanceof RegExp
exports.regex = isRegExp(/abc/)
// => true
exports.notRegex = isRegExp('/abc/')
// => false
================================================
FILE: src/content/lodash/lang/isSafeInteger/lodash.js
================================================
// https://lodash.com/docs/#isSafeInteger
import { isSafeInteger } from 'lodash'
exports.number = isSafeInteger(3)
// => true
exports.minValue = isSafeInteger(Number.MIN_VALUE)
// => false
exports.infinity = isSafeInteger(Infinity)
// => false
exports.string = isSafeInteger('3')
// => false
================================================
FILE: src/content/lodash/lang/isSafeInteger/notes.md
================================================
Checks if value is a safe integer. An integer is safe if it's an IEEE-754 double precision number which isn't the result of a rounded unsafe integer.
Resources: [Number.isSafeInteger](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isSafeInteger)
================================================
FILE: src/content/lodash/lang/isSafeInteger/spec.js
================================================
const expected = {
number: true,
minValue: false,
infinity: false,
string: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isSafeInteger', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isSafeInteger/vanilla.js
================================================
const isSafeInteger = n => Number.isSafeInteger(n)
exports.number = isSafeInteger(3)
// => true
exports.minValue = isSafeInteger(Number.MIN_VALUE)
// => false
exports.infinity = isSafeInteger(Infinity)
// => false
exports.string = isSafeInteger('3')
// => false
================================================
FILE: src/content/lodash/lang/isSet/lodash.js
================================================
// https://lodash.com/docs/#isSet
import { isSet } from 'lodash'
exports.setValue = isSet(new Set())
// => true
exports.weakSetValue = isSet(new WeakSet())
// => false
================================================
FILE: src/content/lodash/lang/isSet/notes.md
================================================
Checks if value is an instance of Set.
Resources: [Node.js](https://nodejs.org/api/util.html#utiltypesissetvalue) [node-util](https://github.com/browserify/node-util/)
================================================
FILE: src/content/lodash/lang/isSet/spec.js
================================================
const expected = {
setValue: true,
weakSetValue: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isSet', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isSet/vanilla.js
================================================
// Since Node.js v10+, it's available in the util library
// https://nodejs.org/api/util.html##util_util_types_isset_value
//
// This implementation is a simplified version of the one found
// in the polyfill module node-util (and it doesn't support IE)
const isSet = value => value.toString() === '[object Set]'
exports.setValue = isSet(new Set())
// => true
exports.weakSetValue = isSet(new WeakSet())
// => false
================================================
FILE: src/content/lodash/lang/isString/lodash.js
================================================
// https://lodash.com/docs/#isString
import { isString } from 'lodash'
exports.string = isString('abc')
// => true
exports.notString = isString(1)
// => false
================================================
FILE: src/content/lodash/lang/isString/notes.md
================================================
Checks if value is classified as a String primitive or object.
Resources: [typeof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/typeof)
================================================
FILE: src/content/lodash/lang/isString/spec.js
================================================
const expected = {
string: true,
notString: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isString', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isString/vanilla.js
================================================
const isString = a => typeof a === 'string'
exports.string = isString('abc')
// => true
exports.notString = isString(1)
// => false
================================================
FILE: src/content/lodash/lang/isSymbol/lodash.js
================================================
// https://lodash.com/docs/#isSymbol
import { isSymbol } from 'lodash'
exports.symbolValue = isSymbol(Symbol.iterator)
// => true
exports.notSymbolValue = isSymbol('abc')
// => false
================================================
FILE: src/content/lodash/lang/isSymbol/notes.md
================================================
Checks if value is an instance of Symbol.
================================================
FILE: src/content/lodash/lang/isSymbol/spec.js
================================================
const expected = {
symbolValue: true,
notSymbolValue: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isSymbol', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isSymbol/vanilla.js
================================================
const isSymbol = symbolMaybe => typeof symbolMaybe === 'symbol'
exports.symbolValue = isSymbol(Symbol.iterator)
// => true
exports.notSymbolValue = isSymbol('abc')
// => false
================================================
FILE: src/content/lodash/lang/isTypedArray/lodash.js
================================================
import { isTypedArray } from 'util/types'
exports.uint8Array = isTypedArray(new Uint8Array())
// => true
exports.float64Array = isTypedArray(new Float64Array())
// => true
exports.arrayBuffer = isTypedArray(new ArrayBuffer())
// => false
================================================
FILE: src/content/lodash/lang/isTypedArray/notes.md
================================================
Checks if value is classified as a typed array.
Resources: [Node.js](https://nodejs.org/api/util.html#utiltypesistypedarrayvalue) [underscore.js](https://underscorejs.org/docs/modules/isTypedArray.html)
================================================
FILE: src/content/lodash/lang/isTypedArray/spec.js
================================================
const expected = {
uint8Array: true,
float64Array: true,
arrayBuffer: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isTypedArray', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isTypedArray/vanilla.js
================================================
// Since Node.js v10+, it's available in the util library
// https://nodejs.org/api/util.html#utiltypesistypedarrayvalue
//
// This implementation is a simplified version of the one found
// in underscore.js (and it doesn't support IE some early Edge versions)
// the Regex tests on whether the Object.toString of the array passed matches any
// typed array. I.e.: [object Int32Array] or [object Float64Array]
const typedArrayPattern =
/\[object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\]/
const isTypedArray = value =>
typedArrayPattern.test(Object.prototype.toString.call(value))
exports.uint8Array = isTypedArray(new Uint8Array())
// => true
exports.float64Array = isTypedArray(new Float64Array())
// => true
exports.arrayBuffer = isTypedArray(new ArrayBuffer())
// => false
================================================
FILE: src/content/lodash/lang/isUndefined/lodash.js
================================================
// https://lodash.com/docs/#isUndefined
import { isUndefined } from 'lodash'
exports.undefVal = isUndefined(undefined)
// => true
exports.nullVal = isUndefined(null)
// => false
================================================
FILE: src/content/lodash/lang/isUndefined/notes.md
================================================
Checks if value is undefined.
Resources: [Equality comparisons](https://developer.mozilla.org/docs/Web/JavaScript/Equality_comparisons_and_sameness)
================================================
FILE: src/content/lodash/lang/isUndefined/spec.js
================================================
const expected = {
nullVal: false,
undefVal: true,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isUndefined', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isUndefined/vanilla.js
================================================
const isUndefined = val => val === undefined
exports.undefVal = isUndefined(undefined)
// => true
exports.nullVal = isUndefined(null)
// => false
================================================
FILE: src/content/lodash/lang/isWeakMap/lodash.js
================================================
// https://lodash.com/docs/#isWeakMap
import { isWeakMap } from 'lodash'
exports.weakMapValue = isWeakMap(new WeakMap())
// => true
exports.weakSetValue = isWeakMap(new WeakSet())
// => false
================================================
FILE: src/content/lodash/lang/isWeakMap/notes.md
================================================
Checks if value is an instance of WeakMap.
Resources: [Node.js](https://nodejs.org/api/util.html#utiltypesisweakmapvalue) [node-util](https://github.com/browserify/node-util/)
================================================
FILE: src/content/lodash/lang/isWeakMap/spec.js
================================================
const expected = {
weakMapValue: true,
weakSetValue: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isSet', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isWeakMap/vanilla.js
================================================
// Since Node.js v10+, it's available in the util library
// https://nodejs.org/api/util.html##utiltypesisweakmapvalue
//
// This implementation is a simplified version of the one found
// in the polyfill module node-util (and it doesn't support IE)
const isWeakMap = value => value.toString() === '[object WeakMap]'
exports.weakMapValue = isWeakMap(new WeakMap())
// => true
exports.weakSetValue = isWeakMap(new WeakSet())
// => false
================================================
FILE: src/content/lodash/lang/isWeakSet/lodash.js
================================================
// https://lodash.com/docs/#isWeakSet
import { isWeakSet } from 'lodash'
exports.weakSetValue = isWeakSet(new WeakSet())
// => true
exports.weakMapValue = isWeakSet(new WeakMap())
// => false
================================================
FILE: src/content/lodash/lang/isWeakSet/notes.md
================================================
Checks if value is an instance of WeakSet.
Resources: [Node.js](https://nodejs.org/api/util.html#utiltypesisweaksetvalue) [node-util](https://github.com/browserify/node-util/)
================================================
FILE: src/content/lodash/lang/isWeakSet/spec.js
================================================
const expected = {
weakMapValue: false,
weakSetValue: true,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('isWeakSet', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/isWeakSet/vanilla.js
================================================
// Since Node.js v10+, it's available in the util library
// https://nodejs.org/api/util.html#utiltypesisweaksetvalue
//
// This implementation is a simplified version of the one found
// in the polyfill module node-util (and it doesn't support IE)
const isWeakSet = value => value.toString() === '[object WeakSet]'
exports.weakSetValue = isWeakSet(new WeakSet())
// => true
exports.weakMapValue = isWeakSet(new WeakMap())
// => false
================================================
FILE: src/content/lodash/lang/lt/lodash.js
================================================
// https://lodash.com/docs/#lt
import { lt } from 'lodash'
exports.default = lt(1, 3)
// => true
exports.equal = lt(3, 3)
// => false
exports.flase = lt(3, 1)
// => false
================================================
FILE: src/content/lodash/lang/lt/notes.md
================================================
Checks if value is less than other.
Resources: [Comparison Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Comparison_Operators)
================================================
FILE: src/content/lodash/lang/lt/spec.js
================================================
const expected = {
default: true,
equal: false,
flase: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('lt', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/lt/vanilla.js
================================================
const lt = (a, b) => a < b
exports.default = lt(1, 3)
// => true
exports.equal = lt(3, 3)
// => false
exports.flase = lt(3, 1)
// => false
================================================
FILE: src/content/lodash/lang/lte/lodash.js
================================================
// https://lodash.com/docs/#lte
import { lte } from 'lodash'
exports.default = lte(1, 3)
// => true
exports.equal = lte(3, 3)
// => true
exports.flase = lte(3, 1)
// => false
================================================
FILE: src/content/lodash/lang/lte/notes.md
================================================
Checks if value is less than or equal to other.
Resources: [Comparison Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Comparison_Operators)
================================================
FILE: src/content/lodash/lang/lte/spec.js
================================================
const expected = {
default: true,
equal: true,
flase: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('lt', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/lang/lte/vanilla.js
================================================
const lte = (a, b) => a <= b
exports.default = lte(1, 3)
// => true
exports.equal = lte(3, 3)
// => false
exports.flase = lte(3, 1)
// => false
================================================
FILE: src/content/lodash/math/add/lodash.js
================================================
// https://lodash.com/docs/#add
import { add } from 'lodash'
module.exports = add(6, 4)
// => 10
================================================
FILE: src/content/lodash/math/add/notes.md
================================================
Adds two numbers.
================================================
FILE: src/content/lodash/math/add/spec.js
================================================
const expected = 10
const lodash = require('./lodash')
const plain = require('./vanilla')
test('add', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/add/vanilla.js
================================================
const add = (a, b) => a + b
module.exports = add(6, 4)
// => 10
================================================
FILE: src/content/lodash/math/ceil/lodash.js
================================================
// https://lodash.com/docs/#ceil
import { ceil } from 'lodash'
exports.ceil = ceil(4.006)
// => 5
exports.precision = ceil(6.004, 2)
// => 6.01
exports.negPrecision = ceil(6040, -2)
// => 6100
================================================
FILE: src/content/lodash/math/ceil/notes.md
================================================
Computes number rounded up to precision.
Resources: [Assignment Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Assignment_Operators#Exponentiation_assignment)
================================================
FILE: src/content/lodash/math/ceil/spec.js
================================================
const expected = {
ceil: 5,
precision: 6.01,
negPrecision: 6100,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('ceil', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/ceil/vanilla.js
================================================
const ceil = (num, precision) => {
const modifier = 10 ** precision
return Math.ceil(num * modifier) / modifier
}
exports.ceil = Math.ceil(4.006)
// => 5
exports.precision = ceil(6.004, 2)
// => 6.01
exports.negPrecision = ceil(6040, -2)
// => 6100
================================================
FILE: src/content/lodash/math/divide/lodash.js
================================================
// https://lodash.com/docs/#divide
import { divide } from 'lodash'
module.exports = divide(6, 4)
// => 1.5
================================================
FILE: src/content/lodash/math/divide/notes.md
================================================
Divide two numbers.
================================================
FILE: src/content/lodash/math/divide/spec.js
================================================
const expected = 1.5
const lodash = require('./lodash')
const plain = require('./vanilla')
test('divide', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/divide/vanilla.js
================================================
const divide = (a, b) => a / b
module.exports = divide(6, 4)
// => 1.5
================================================
FILE: src/content/lodash/math/floor/lodash.js
================================================
// https://lodash.com/docs/#floor
import { floor } from 'lodash'
exports.floor = floor(4.006)
// => 4
exports.precision = floor(0.046, 2)
// => 0.04
exports.negPrecision = floor(4060, -2)
// => 4000
================================================
FILE: src/content/lodash/math/floor/notes.md
================================================
Computes number rounded down to precision.
Resources: [Assignment Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Assignment_Operators#Exponentiation_assignment)
================================================
FILE: src/content/lodash/math/floor/spec.js
================================================
const expected = {
floor: 4,
precision: 0.04,
negPrecision: 4000,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('floor', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/floor/vanilla.js
================================================
const floor = (num, precision) => {
const modifier = 10 ** precision
return Math.floor(num * modifier) / modifier
}
exports.floor = Math.floor(4.006)
// => 4
exports.precision = floor(0.046, 2)
// => 0.04
exports.negPrecision = floor(4060, -2)
// => 4000
================================================
FILE: src/content/lodash/math/max/lodash.js
================================================
// https://lodash.com/docs/#max
import { max } from 'lodash'
exports.max = max([4, 2, 8, 6])
// => 8
exports.undefined = max([])
// => undefined
================================================
FILE: src/content/lodash/math/max/notes.md
================================================
Computes the maximum value of array. If array is empty or falsey, undefined is returned.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/math/max/spec.js
================================================
const expected = {
max: 8,
undefined,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('max', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/max/vanilla.js
================================================
const max = nums => {
if (nums.length) return Math.max(...nums)
}
exports.max = max([4, 2, 8, 6])
// => 8
exports.undefined = max([])
// => undefined
================================================
FILE: src/content/lodash/math/maxBy/lodash.js
================================================
// https://lodash.com/docs/#maxBy
import { maxBy } from 'lodash'
const objects = [{ n: 1 }, { n: 2 }]
module.exports = maxBy(objects, o => o.n)
// => { 'n': 2 }
================================================
FILE: src/content/lodash/math/maxBy/notes.md
================================================
This method is like \_.max except that it accepts iteratee which is invoked for each element in array to generate the criterion by which the value is ranked. The iteratee is invoked with one argument: (value).
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/math/maxBy/spec.js
================================================
const expected = { n: 2 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('maxBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/maxBy/vanilla.js
================================================
const maxBy = (arr, func) => {
const max = Math.max(...arr.map(func))
return arr.find(item => func(item) === max)
}
const objects = [{ n: 1 }, { n: 2 }]
module.exports = maxBy(objects, o => o.n)
// => { 'n': 2 }
================================================
FILE: src/content/lodash/math/mean/lodash.js
================================================
// https://lodash.com/docs/#mean
import { mean } from 'lodash'
module.exports = mean([4, 2, 8, 6])
// => 5
================================================
FILE: src/content/lodash/math/mean/notes.md
================================================
Computes the mean of the values in array.
Resources: [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/math/mean/spec.js
================================================
const expected = 5
const lodash = require('./lodash')
const plain = require('./vanilla')
test('mean', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/mean/vanilla.js
================================================
const mean = arr => arr.reduce((acc, num) => acc + num, 0) / arr.length
module.exports = mean([4, 2, 8, 6])
// => 5
================================================
FILE: src/content/lodash/math/meanBy/lodash.js
================================================
// https://lodash.com/docs/#meanBy
import { meanBy } from 'lodash'
const objects = [{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }]
module.exports = meanBy(objects, o => o.n)
// => 5
================================================
FILE: src/content/lodash/math/meanBy/notes.md
================================================
This method is like \_.mean except that it accepts iteratee which is invoked for each element in array to generate the value to be averaged. The iteratee is invoked with one argument: (value).
Resources: [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/math/meanBy/spec.js
================================================
const expected = 5
const lodash = require('./lodash')
const plain = require('./vanilla')
test('meanBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/meanBy/vanilla.js
================================================
const meanBy = (arr, func) =>
arr.reduce((acc, item) => acc + func(item), 0) / arr.length
const objects = [{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }]
module.exports = meanBy(objects, o => o.n)
// => 5
================================================
FILE: src/content/lodash/math/min/lodash.js
================================================
// https://lodash.com/docs/#min
import { min } from 'lodash'
exports.min = min([4, 2, 8, 6])
// => 2
exports.undefined = min([])
// => undefined
================================================
FILE: src/content/lodash/math/min/notes.md
================================================
Computes the minimum value of array. If array is empty or falsey, undefined is returned.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/math/min/spec.js
================================================
const expected = {
min: 2,
undefined,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('min', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/min/vanilla.js
================================================
const min = nums => {
if (nums.length) return Math.min(...nums)
}
exports.min = min([4, 2, 8, 6])
// => 2
exports.undefined = min([])
// => undefined
================================================
FILE: src/content/lodash/math/minBy/lodash.js
================================================
// https://lodash.com/docs/#minBy
import { minBy } from 'lodash'
const objects = [{ n: 1 }, { n: 2 }]
module.exports = minBy(objects, o => o.n)
// => { 'n': 1 }
================================================
FILE: src/content/lodash/math/minBy/notes.md
================================================
This method is like \_.min except that it accepts iteratee which is invoked for each element in array to generate the criterion by which the value is ranked. The iteratee is invoked with one argument: (value).
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/math/minBy/spec.js
================================================
const expected = { n: 1 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('sumBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/minBy/vanilla.js
================================================
const minBy = (arr, func) => {
const min = Math.min(...arr.map(func))
return arr.find(item => func(item) === min)
}
const objects = [{ n: 1 }, { n: 2 }]
module.exports = minBy(objects, o => o.n)
// => { 'n': 1 }
================================================
FILE: src/content/lodash/math/multiply/lodash.js
================================================
// https://lodash.com/docs/#multiply
import { multiply } from 'lodash'
module.exports = multiply(6, 4)
// => 24
================================================
FILE: src/content/lodash/math/multiply/notes.md
================================================
Multiply two numbers.
================================================
FILE: src/content/lodash/math/multiply/spec.js
================================================
const expected = 24
const lodash = require('./lodash')
const plain = require('./vanilla')
test('multiply', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/multiply/vanilla.js
================================================
const multiply = (a, b) => a * b
module.exports = multiply(6, 4)
// => 24
================================================
FILE: src/content/lodash/math/round/lodash.js
================================================
// https://lodash.com/docs/#round
import { round } from 'lodash'
exports.round = round(4.006)
// => 4
exports.precision = round(4.006, 2)
// => 4.01
exports.negPrecision = round(4060, -2)
// => 4100
================================================
FILE: src/content/lodash/math/round/notes.md
================================================
Computes number rounded to precision.
Resources: [Assignment Operators](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Assignment_Operators#Exponentiation_assignment)
================================================
FILE: src/content/lodash/math/round/spec.js
================================================
const expected = {
round: 4,
precision: 4.01,
negPrecision: 4100,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('round', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/round/vanilla.js
================================================
const round = (num, precision) => {
const modifier = 10 ** precision
return Math.round(num * modifier) / modifier
}
exports.round = Math.round(4.006)
// => 4
exports.precision = round(4.006, 2)
// => 4.01
exports.negPrecision = round(4060, -2)
// => 4100
================================================
FILE: src/content/lodash/math/subtract/lodash.js
================================================
// https://lodash.com/docs/#subtract
import { subtract } from 'lodash'
module.exports = subtract(6, 4)
// => 2
================================================
FILE: src/content/lodash/math/subtract/notes.md
================================================
Subtract two numbers.
================================================
FILE: src/content/lodash/math/subtract/spec.js
================================================
const expected = 2
const lodash = require('./lodash')
const plain = require('./vanilla')
test('subtract', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/subtract/vanilla.js
================================================
const subtract = (a, b) => a - b
module.exports = subtract(6, 4)
// => 2
================================================
FILE: src/content/lodash/math/sum/lodash.js
================================================
// https://lodash.com/docs/#sum
import { sum } from 'lodash'
module.exports = sum([4, 2, 8, 6])
// => 20
================================================
FILE: src/content/lodash/math/sum/notes.md
================================================
Computes the sum of the values in array.
Resources: [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/math/sum/spec.js
================================================
const expected = 20
const lodash = require('./lodash')
const plain = require('./vanilla')
test('sum', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/sum/vanilla.js
================================================
module.exports = [4, 2, 8, 6].reduce((acc, num) => {
acc += num
return acc
}, 0)
// => 20
================================================
FILE: src/content/lodash/math/sumBy/lodash.js
================================================
// https://lodash.com/docs/#sumBy
import { sumBy } from 'lodash'
const objects = [{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }]
module.exports = sumBy(objects, o => o.n)
// => 20
================================================
FILE: src/content/lodash/math/sumBy/notes.md
================================================
This method is like \_.sum except that it accepts iteratee which is invoked for each element in array to generate the value to be summed. The iteratee is invoked with one argument: (value).
Resources: [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/math/sumBy/spec.js
================================================
const expected = 20
const lodash = require('./lodash')
const plain = require('./vanilla')
test('sumBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/math/sumBy/vanilla.js
================================================
const sumBy = (arr, func) => arr.reduce((acc, item) => acc + func(item), 0)
const objects = [{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }]
module.exports = sumBy(objects, o => o.n)
// => 20
================================================
FILE: src/content/lodash/number/clamp/lodash.js
================================================
// https://lodash.com/docs/#clamp
import { clamp } from 'lodash'
exports.noOptionalArg = clamp(-10, -5)
// => -10
exports.lower = clamp(-10, -5, 5)
// => -5
exports.higher = clamp(10, -5, 5)
// => 5
================================================
FILE: src/content/lodash/number/clamp/notes.md
================================================
Clamps number within the inclusive lower and upper bounds.
================================================
FILE: src/content/lodash/number/clamp/spec.js
================================================
const expected = {
noOptionalArg: -10,
higher: 5,
lower: -5,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('clamp', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/number/clamp/vanilla.js
================================================
const clamp = (num, clamp, higher) =>
higher ? Math.min(Math.max(num, clamp), higher) : Math.min(num, clamp)
exports.noOptionalArg = clamp(-10, -5)
// => -10
exports.lower = clamp(-10, -5, 5)
// => -5
exports.higher = clamp(10, -5, 5)
// => 5
================================================
FILE: src/content/lodash/number/inRange/lodash.js
================================================
// https://lodash.com/docs/#inRange
import { inRange } from 'lodash'
exports.example1 = inRange(3, 2, 4)
// => true
exports.example2 = inRange(4, 8)
// => true
exports.example3 = inRange(4, 2)
// => false
exports.example4 = inRange(2, 2)
// => false
exports.example5 = inRange(1.2, 2)
// => true
exports.example6 = inRange(5.2, 4)
// => false
exports.example7 = inRange(-3, -2, -6)
// => true
================================================
FILE: src/content/lodash/number/inRange/notes.md
================================================
Checks if n is between start and up to, but not including, end. If end is not specified, it's set to start with start then set to 0. If start is greater than end the params are swapped to support negative ranges.
Resources: [Default parameters](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Functions/Default_parameters)
================================================
FILE: src/content/lodash/number/inRange/spec.js
================================================
const expected = {
example1: true,
example2: true,
example3: false,
example4: false,
example5: true,
example6: false,
example7: true,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('inRange', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/number/inRange/vanilla.js
================================================
const inRange = (num, rangeStart, rangeEnd = 0) =>
(rangeStart < num && num < rangeEnd) || (rangeEnd < num && num < rangeStart)
exports.example1 = inRange(3, 2, 4)
// => true
exports.example2 = inRange(4, 8)
// => true
exports.example3 = inRange(4, 2)
// => false
exports.example4 = inRange(2, 2)
// => false
exports.example5 = inRange(1.2, 2)
// => true
exports.example6 = inRange(5.2, 4)
// => false
exports.example7 = inRange(-3, -2, -6)
// => true
================================================
FILE: src/content/lodash/number/random/lodash.js
================================================
// https://lodash.com/docs/#random
import { random } from 'lodash'
exports.integer05 = random(0, 5)
// => an integer between 0 and 5
exports.integer5 = random(5)
// => also an integer between 0 and 5
exports.floating5 = random(5, true)
// => a floating-point number between 0 and 5
exports.floating = random(1.2, 5.2)
// => a floating-point number between 1.2 and 5.2
exports.integer = random()
// => 0 or 1
exports.negative = random(-1)
// => -1 or 0
================================================
FILE: src/content/lodash/number/random/notes.md
================================================
Produces a random number between the inclusive lower and upper bounds. If only one argument is provided a number between 0 and the given number is returned. If floating is true, or either lower or upper are floats, a floating-point number is returned instead of an integer.
Note: JavaScript follows the IEEE-754 standard for resolving floating-point values which can produce unexpected results.
Resources: [Number.isInteger](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isInteger) [isNaN](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/isNaN)
================================================
FILE: src/content/lodash/number/random/spec.js
================================================
const lodash = require('./lodash')
const plain = require('./vanilla')
test('random(0, 5)', () => {
expect(lodash.integer05).toBeGreaterThanOrEqual(0)
expect(plain.integer05).toBeGreaterThanOrEqual(0)
expect(lodash.integer05).toBeLessThanOrEqual(5)
expect(plain.integer05).toBeLessThanOrEqual(5)
expect([0, 1, 2, 3, 4, 5]).toContain(lodash.integer05)
expect([0, 1, 2, 3, 4, 5]).toContain(plain.integer05)
})
test('random(5)', () => {
expect(lodash.integer5).toBeGreaterThanOrEqual(0)
expect(plain.integer5).toBeGreaterThanOrEqual(0)
expect(lodash.integer5).toBeLessThanOrEqual(5)
expect(plain.integer5).toBeLessThanOrEqual(5)
expect([0, 1, 2, 3, 4, 5]).toContain(lodash.integer5)
expect([0, 1, 2, 3, 4, 5]).toContain(plain.integer5)
})
test('random(5, true)', () => {
expect(lodash.floating5).toBeGreaterThanOrEqual(0)
expect(plain.floating5).toBeGreaterThanOrEqual(0)
expect(lodash.floating5).toBeLessThanOrEqual(5)
expect(plain.floating5).toBeLessThanOrEqual(5)
expect([0, 1, 2, 3, 4, 5]).not.toContain(lodash.floating5)
expect([0, 1, 2, 3, 4, 5]).not.toContain(plain.floating5)
})
test('random(1.2, 5.2)', () => {
expect(lodash.floating).toBeGreaterThanOrEqual(1.2)
expect(plain.floating).toBeGreaterThanOrEqual(1.2)
expect(lodash.floating).toBeLessThanOrEqual(5.2)
expect(plain.floating).toBeLessThanOrEqual(5.2)
expect([0, 1, 2, 3, 4, 5]).not.toContain(lodash.floating)
expect([0, 1, 2, 3, 4, 5]).not.toContain(plain.floating)
})
test('random()', () => {
expect([0, 1]).toContain(lodash.integer)
expect([0, 1]).toContain(plain.integer)
})
test('random(-1)', () => {
expect(lodash.negative).toBeLessThanOrEqual(0)
expect(plain.negative).toBeLessThanOrEqual(0)
expect([0, -1]).toContain(lodash.negative)
expect([0, -1]).toContain(plain.negative)
})
================================================
FILE: src/content/lodash/number/random/vanilla.js
================================================
const random = (lower = 0, upper, floating) => {
if (typeof upper === 'boolean') {
floating = upper
}
if (isNaN(upper)) {
upper = lower < 0 ? 0 : 1
}
if (typeof floating === 'undefined') {
floating = !Number.isInteger(lower) || !Number.isInteger(upper)
}
const randomNumber = Math.random() * (upper - lower) + lower
return floating ? randomNumber : Math.round(randomNumber)
}
exports.integer05 = random(0, 5)
// => an integer between 0 and 5
exports.integer5 = random(5)
// => also an integer between 0 and 5
exports.floating5 = random(5, true)
// => a floating-point number between 0 and 5
exports.floating = random(1.2, 5.2)
// => a floating-point number between 1.2 and 5.2
exports.integer = random()
// => 0 or 1
exports.negative = random(-1)
// => -1 or 0
================================================
FILE: src/content/lodash/object/assign/lodash.js
================================================
// https://lodash.com/docs/#assign
import { assign } from 'lodash'
function Foo() {
this.a = 1
}
function Bar() {
this.c = 3
}
Foo.prototype.b = 2
Bar.prototype.d = 4
module.exports = assign({ a: 0 }, new Foo(), new Bar())
// => { 'a': 1, 'c': 3 }
================================================
FILE: src/content/lodash/object/assign/notes.md
================================================
Assigns own enumerable string keyed properties of source objects to the destination object. Source objects are applied from left to right. Subsequent sources overwrite property assignments of previous sources.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax)
================================================
FILE: src/content/lodash/object/assign/spec.js
================================================
const expected = { a: 1, c: 3 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('assign', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/assign/vanilla.js
================================================
function Foo() {
this.a = 1
}
function Bar() {
this.c = 3
}
Foo.prototype.b = 2
Bar.prototype.d = 4
module.exports = { a: 0, ...new Foo(), ...new Bar() }
// => { 'a': 1, 'c': 3 }
================================================
FILE: src/content/lodash/object/create/lodash.js
================================================
// https://lodash.com/docs/#create
import { create } from 'lodash'
function Shape() {
this.x = 0
this.y = 0
}
function Circle() {
Shape.call(this)
}
Circle.prototype = create(Shape.prototype, {
constructor: Circle,
})
const circle = new Circle()
exports.circle = circle instanceof Circle
// => true
exports.shape = circle instanceof Shape
// => true
================================================
FILE: src/content/lodash/object/create/notes.md
================================================
Creates an object that inherits from the prototype object. If a properties object is given, its own enumerable string keyed properties are assigned to the created object.
Resources: [Object.assign](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign) [Object.create](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/create) [instanceof](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/instanceof)
================================================
FILE: src/content/lodash/object/create/spec.js
================================================
const expected = {
circle: true,
shape: true,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('create', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/create/vanilla.js
================================================
function Shape() {
this.x = 0
this.y = 0
}
function Circle() {
Shape.call(this)
}
Circle.prototype = Object.assign(Object.create(Shape.prototype), {
constructor: Circle,
})
const circle = new Circle()
exports.circle = circle instanceof Circle
// => true
exports.shape = circle instanceof Shape
// => true
================================================
FILE: src/content/lodash/object/defaults/lodash.js
================================================
// https://lodash.com/docs/#defaults
import { defaults } from 'lodash'
module.exports = defaults({ a: 1 }, { b: 2 }, { a: 3 })
// // => { 'a': 1, 'b': 2 }
================================================
FILE: src/content/lodash/object/defaults/notes.md
================================================
Assigns own and inherited enumerable string keyed properties of source objects to the destination object for all destination properties that resolve to undefined. Source objects are applied from left to right. Once a property is set, additional values of the same property are ignored.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#reverse](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse) [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/object/defaults/spec.js
================================================
const expected = { a: 1, b: 2 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('defaults', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/defaults/vanilla.js
================================================
const defaults = (...args) =>
args.reverse().reduce((acc, obj) => ({ ...acc, ...obj }), {})
module.exports = defaults({ a: 1 }, { b: 2 }, { a: 3 })
// // => { 'a': 1, 'b': 2 }
================================================
FILE: src/content/lodash/object/get/lodash.js
================================================
// https://lodash.com/docs/#get
import { get } from 'lodash'
const simpleObject = { a: { b: 2 } }
const complexObject = { a: [{ bar: { c: 3 } }] }
const falsyObject = { a: null, b: undefined, c: 0 }
exports.simplePath = get(simpleObject, 'a.b')
// => 2
exports.complexPath = get(complexObject, 'a[0].bar.c')
// => 3
exports.complexPathArray = get(complexObject, ['a', '0', 'bar', 'c'])
// => 2
exports.simpleDefault = get(simpleObject, 'a.bar.c', 'default')
// => 'default'
exports.complexDefault = get(complexObject, 'a.bar.c', 'default')
// => 'default'
exports.falseCase = get(complexObject, null)
// => undefined
exports.nullCase = get(falsyObject, 'a', 'default')
// => null
exports.undefinedCase = get(falsyObject, 'b', 'default')
// => undefined
exports.zeroCase = get(falsyObject, 'c', 'default')
// => zero
================================================
FILE: src/content/lodash/object/get/notes.md
================================================
Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
Resources: [Array.isArray](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray) [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce) [Array#filter](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) [xkcd](https://xkcd.com/1171/)
================================================
FILE: src/content/lodash/object/get/spec.js
================================================
const expected = {
simplePath: 2,
complexPath: 3,
complexPathArray: 3,
simpleDefault: 'default',
complexDefault: 'default',
falseCase: undefined,
nullCase: null,
zeroCase: 0,
undefinedCase: 'default',
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('get', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/get/vanilla.js
================================================
const get = (obj, path, defValue) => {
// If path is not defined or it has false value
if (!path) return undefined
// Check if path is string or array. Regex : ensure that we do not have '.' and brackets.
// Regex explained: https://regexr.com/58j0k
const pathArray = Array.isArray(path) ? path : path.match(/([^[.\]])+/g)
// Find value
const result = pathArray.reduce(
(prevObj, key) => prevObj && prevObj[key],
obj
)
// If found value is undefined return default value; otherwise return the value
return result === undefined ? defValue : result
}
const simpleObject = { a: { b: 2 } }
const complexObject = { a: [{ bar: { c: 3 } }] }
const falsyObject = { a: null, b: undefined, c: 0 }
exports.simplePath = get(simpleObject, 'a.b')
// => 2
exports.complexPath = get(complexObject, 'a[0].bar.c')
// => 3
exports.complexPathArray = get(complexObject, ['a', '0', 'bar', 'c'])
// => 2
exports.simpleDefault = get(simpleObject, 'a.bar.c', 'default')
// => 'default'
exports.complexDefault = get(complexObject, 'a.bar.c', 'default')
// => 'default
exports.falseCase = get(complexObject, null)
// => undefined
exports.nullCase = get(falsyObject, 'a', 'default')
// => null
exports.undefinedCase = get(falsyObject, 'b', 'default')
// => undefined
exports.zeroCase = get(falsyObject, 'c', 'default')
// => zero
================================================
FILE: src/content/lodash/object/has/lodash.js
================================================
// https://lodash.com/docs/#has
import { has } from 'lodash'
const object = { a: { bar: 2 } }
exports.simple = has(object, 'a')
// => true
exports.nested = has(object, 'a.bar')
// => true
exports.array = has(object, ['a', 'bar'])
// => true
exports.missing = has(object, ['a', 'c'])
// => false
================================================
FILE: src/content/lodash/object/has/notes.md
================================================
Checks if path is a direct property of object.
Resources: [Array.isArray](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray) [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce) [xkcd](https://xkcd.com/1171/)
================================================
FILE: src/content/lodash/object/has/spec.js
================================================
const expected = {
simple: true,
nested: true,
array: true,
missing: false,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('has', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/has/vanilla.js
================================================
const has = (obj, path) => {
// Regex explained: https://regexr.com/58j0k
const pathArray = Array.isArray(path) ? path : path.match(/([^[.\]])+/g)
return !!pathArray.reduce((prevObj, key) => prevObj && prevObj[key], obj)
}
const object = { a: { bar: 2 } }
exports.simple = has(object, 'a')
// => true
exports.nested = has(object, 'a.bar')
// => true
exports.array = has(object, ['a', 'bar'])
// => true
exports.missing = has(object, ['a', 'c'])
// => false
================================================
FILE: src/content/lodash/object/invert/lodash.js
================================================
// https://lodash.com/docs/#invert
import { invert } from 'lodash'
const object = { a: 1, b: 2, c: 1 }
module.exports = invert(object)
// => { '1': 'c', '2': 'b' }
================================================
FILE: src/content/lodash/object/invert/notes.md
================================================
Creates an object composed of the inverted keys and values of object. If object contains duplicate values, subsequent values overwrite property assignments of previous values.
Resources: [Object.entries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries) [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
================================================
FILE: src/content/lodash/object/invert/spec.js
================================================
const expected = { '1': 'c', '2': 'b' }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('invert', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/invert/vanilla.js
================================================
const object = { a: 1, b: 2, c: 1 }
module.exports = Object.entries(object).reduce(
(acc, [key, value]) => ({
...acc,
[value]: key,
}),
{}
)
// => { '1': 'c', '2': 'b' }
================================================
FILE: src/content/lodash/object/keys/lodash.js
================================================
// https://lodash.com/docs/#keys
import { keys } from 'lodash'
function Foo() {
this.a = 1
this.b = 2
}
Foo.prototype.c = 3
exports.instance = keys(new Foo())
// => ['a', 'b'] (iteration order is not guaranteed)
exports.string = keys('hi')
// => ['0', '1']
================================================
FILE: src/content/lodash/object/keys/notes.md
================================================
Creates an array of the own enumerable property names of object.
Resources: [Object.keys](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/keys)
================================================
FILE: src/content/lodash/object/keys/spec.js
================================================
const expected = {
instance: ['a', 'b'],
string: ['0', '1'],
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('instance', () => {
// sorting as the iteration order is not guaranteed
expect(lodash.instance.sort()).toEqual(expected.instance)
expect(plain.instance.sort()).toEqual(lodash.instance)
})
test('string', () => {
expect(lodash.string).toEqual(expected.string)
expect(plain.string).toEqual(lodash.string)
})
================================================
FILE: src/content/lodash/object/keys/vanilla.js
================================================
function Foo() {
this.a = 1
this.b = 2
}
Foo.prototype.c = 3
exports.instance = Object.keys(new Foo())
// => ['a', 'b'] (iteration order is not guaranteed)
exports.string = Object.keys('hi')
// => ['0', '1']
================================================
FILE: src/content/lodash/object/mapKeys/lodash.js
================================================
// https://lodash.com/docs/#mapKeys
import { mapKeys } from 'lodash'
module.exports = mapKeys({ a: 1, b: 2 }, (value, key) => key + value)
// => { 'a1': 1, 'b2': 2 }
================================================
FILE: src/content/lodash/object/mapKeys/notes.md
================================================
The opposite of \_.mapValues; this method creates an object with the same values as object and keys generated by running each own enumerable string keyed property of object thru iteratee. The iteratee is invoked with three arguments: (value, key, object).
Resources: [Object.entries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries) [Array#reduce](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce) [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Computed property names](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Object_initializer#Computed_property_names)
================================================
FILE: src/content/lodash/object/mapKeys/spec.js
================================================
const expected = { a1: 1, b2: 2 }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('mapKeys', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/mapKeys/vanilla.js
================================================
const mapKeys = (obj, mapper) =>
Object.entries(obj).reduce(
(acc, [key, value]) => ({
...acc,
[mapper(value, key)]: value,
}),
{}
)
module.exports = mapKeys({ a: 1, b: 2 }, (value, key) => key + value)
// => { 'a1': 1, 'b2': 2 }
================================================
FILE: src/content/lodash/object/omit/lodash.js
================================================
// https://lodash.com/docs/#omit
import { omit } from 'lodash'
const object = { a: 1, b: '2', c: 3 }
module.exports = omit(object, ['a', 'c'])
// => { 'b': '2' }
================================================
FILE: src/content/lodash/object/omit/notes.md
================================================
The opposite of \_.pick; this method creates an object composed of the own and inherited enumerable property paths of object that are not omitted.
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Array#forEach](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach) [Delete operator](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/delete)
================================================
FILE: src/content/lodash/object/omit/spec.js
================================================
const expected = { b: '2' }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('omit', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/omit/vanilla.js
================================================
const omit = (obj, props) => {
obj = { ...obj }
props.forEach(prop => delete obj[prop])
return obj
}
const object = { a: 1, b: '2', c: 3 }
module.exports = omit(object, ['a', 'c'])
// => { 'b': '2' }
================================================
FILE: src/content/lodash/object/omitBy/lodash.js
================================================
// https://lodash.com/docs/#omitBy
import { omitBy, isNumber } from 'lodash'
const object = { a: 1, b: '2', c: 3 }
module.exports = omitBy(object, isNumber)
// => { 'b': '2' }
================================================
FILE: src/content/lodash/object/omitBy/notes.md
================================================
The opposite of \_.pickBy; this method creates an object composed of the own and inherited enumerable string keyed properties of object that predicate doesn't return truthy for. The predicate is invoked with two arguments: (value, key).
Resources: [Spread syntax](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax) [Object.entries](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/entries) [Array#forEach](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach) [Delete operator](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/delete)
================================================
FILE: src/content/lodash/object/omitBy/spec.js
================================================
const expected = { b: '2' }
const lodash = require('./lodash')
const plain = require('./vanilla')
test('omitBy', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/omitBy/vanilla.js
================================================
const isNumber = a => typeof a === 'number'
const omitBy = (obj, check) => {
obj = { ...obj }
Object.entries(obj).forEach(([key, value]) => check(value) && delete obj[key])
return obj
}
const object = { a: 1, b: '2', c: 3 }
module.exports = omitBy(object, isNumber)
// => { 'b': '2' }
================================================
FILE: src/content/lodash/object/pick/lodash.js
================================================
// https://lodash.com/docs/#pick
import { pick } from 'lodash'
const object = {
a: 1,
b: 2,
c: 3,
}
module.exports = pick(object, ['a', 'c'])
// => {a: 1, c: 3}
================================================
FILE: src/content/lodash/object/pick/notes.md
================================================
Creates an object composed of the picked object properties.
Resources: [Object destructuring](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment#Object_destructuring)
================================================
FILE: src/content/lodash/object/pick/spec.js
================================================
const expected = {
a: 1,
c: 3,
}
const lodash = require('./lodash')
const plain = require('./vanilla')
test('pick', () => {
expect(lodash).toEqual(expected)
expect(plain).toEqual(lodash)
})
================================================
FILE: src/content/lodash/object/pick/vanilla.js
================================================
const object = {
a: 1,
b: 2,
c: 3,
}
const { a, c } = object
module.exports = { a, c }
// => {a: 1, c: 3}
================================================
FILE: src/content/lodash/object/set/lodash.js
================================================
// https://lodash.com/docs/#set
import { set } from 'lodash'
const object = { a: [{ bar: { c: 3 } }] }
set(object, 'a[0].bar.c', 4)
exports.string = object.a[0].bar.c
// => 4
set(object, ['x', '0', 'y', 'z'], 5)
exports.array = object.x[0].y.z
// => 5
================================================
FILE: src/content/lodash/object/set/notes.md
================================================
Sets the value at path of object. If a portion of path doesn't exist, it's created. Arrays are created for missing index properties while objects are created for all other missing properties. Use \_.setWith to customize path creation.
[//]: contributor-faces
================================================
FILE: jest.setup.js
================================================
// require('jest-mock-now')()
const { advanceTo } = require('jest-date-mock')
advanceTo(new Date(2014, 8, 25, 18, 30, 15, 500).getTime())
================================================
FILE: modules/contributors.js
================================================
const path = require('path')
const gh = require('gh-got')
const readmeFilename = require('readme-filename')
const replace = require('replace-in-file')
const customContributorList = ['doydoy44']
const generateHtml = data =>
data.reduce(
(html, { html_url, avatar_url, login }) =>
html +
`