🙏 단위를 지정해주세요! 📏

이 코드는 무엇입니까?

const success = myCache.mset([
    {key: "myKey", val: obj, ttl: 10000},
    {key: "myKey2", val: obj2},
]);

ttl가 10,000밀리초, 초 또는 다른 것인지 전혀 명확하지 않습니다. 이 코드를 보면(그리고 JavaScriptsetTimeout()가 밀리초를 사용한다는 것을 알면) 밀리초 단위라고 생각하고 싶을 수도 있습니다. 잘못된! 몇 초 안에 완료됩니다!

이 스니펫은 node-cache 의 README에 있는 예제 코드입니다. 이러한 유형의 불명확한 코드는 실제로 널리 퍼져 있으므로 특별히 선택하려고 하지 않습니다. 다행스럽게도 README에는 몇 초 안에 완료된다고 나와 있지만 확인하려면 RTFM 해야 합니다. 누가 그럴 시간이 있겠습니까?
ttl 속성의 이름을 ttlSeconds로 지정하면 좋지 않을까요? 그러면 코드를 읽는 사람에게 그것이 의미하는 바가 즉시 명확해집니다.

아니면 더 나은 해결책이 있을 수도 있습니다.

날짜/시간

날짜/시간이 Unix 시대(1970년 1월 1일 00:00:00 UTC) 이후 정수 밀리초(또는 초)로 표현되는 것도 꽤 일반적입니다. 예를 들어:

const myBirthday = 700876800000;

이것도 짜증나. 이것이 Unix 시대 이후의 밀리초일 가능성이 매우 높다는 것을 인식할 수 있지만 이것이 어떤 날짜를 나타내는지는 알 수 없습니다.

대신 다음은 어떻습니까?

const myBirthday = new Date('1992-03-18T00:00:00.000Z');

이제 이 코드를 읽는 사람은 코드가 나타내는 날짜를 정확히 알고 있으며 myBirthday에 액세스하는 코드도 알고 있습니다. 주변 코드는 이 값number이 초인지 밀리초인지에 대한 부족 지식이 필요하지 않습니다. Date 이며 매우 구체적인 의미가 있습니다.

시간대

TTL(Time to Live)로 다시 점프합니다. TTL은 특정 날짜 및 시간이 아니라 시간 길이(1초, 1년 등)이므로 Date를 사용하여 표시할 수 없습니다.

명확성을 위해 TTL 속성ttlSeconds의 이름을 지정하는 것은 많은 경우에 훌륭한 솔루션이지만 이에 대해 Date와 유사한 데이터 유형이 있다면 어떻게 될까요?

Some languages에는 실제로 이러한 기능이 내장되어 있습니다. JavaScript는 그렇지 않지만 timespan과 같은 패키지를 사용할 수 있습니다.

import timespan from 'timespan';

const ttl = timespan.fromSeconds(50);

console.log(ttl.totalMilliseconds()); // 50000
console.log(ttl.totalSeconds()); // 50
console.log(ttl.totalMinutes()); // 0.8333333333333334

원하는 단위로 TTL을 지정할 수 있으며 TTL을 전달하는 코드는 원하는 단위로 읽을 수 있습니다. 단위에 대해 전혀 동의할 필요가 없습니다.

If only NASA used constructs like this , 그들은 몇 달러를 절약할 수 있었을 것입니다.

결론

여기서 가슴에서 벗어나고 싶었던 짧은 것. 많은 버그는 사용 중인 단위에 대한 혼동에 뿌리를 두고 있습니다. 다행스럽게도 이러한 종류의 위험을 완화할 수 있는 몇 가지 도구가 있습니다. 나는 그들이 더 자주 사용되는 것을 보았으면 좋겠다!