Nhập tĩnh với Flow trong React

Ảnh của Mike Lewis HeadSmart Media trên Unsplash

Trong các ứng dụng React / JavaScript của tôi, có ba lớp phát triển “an toàn” mà tôi luôn thêm vào:

  1. ESLint, để đảm bảo mã tuân theo một tiêu chuẩn nhất định
  2. Kiểm tra đơn vị, để đảm bảo mã có thể kiểm tra được
  3. Nhập tĩnh, để thêm rõ ràng và giảm nhầm lẫn

Có một số công nghệ chúng ta có thể sử dụng để thêm tính năng nhập tĩnh trong JavaScript, với TypeScript (TS) là công nghệ phổ biến nhất. Nó được phát triển bởi Microsoft vào năm 2012 và có một cộng đồng lớn. Các thư viện giao diện người dùng chính như Angular, Vue và React đều hỗ trợ TS.

Nhưng cá nhân tôi thích Flow hơn TS. Flow được Facebook phát triển vào năm 2014. Đây là những lý do (có thể là chủ quan) khiến tôi thích Flow hơn:

  1. Nó được phát triển bởi Facebook (người đã phát triển React, thư viện giao diện người dùng yêu thích của tôi). Vì vậy, React tự nhiên hoạt động tốt hơn với Flow . *
  2. Để tạo tệp JS để sử dụng Flow, tôi chỉ cần thêm một dòng trên đầu tệp ( //@flow). Phần mở rộng của tệp sẽ vẫn là .js.
  3. TS là một ngôn ngữ hoàn toàn mới với phần mở rộng tệp riêng ( .ts). Mặc dù Flow là công cụ kiểm tra kiểu khác mà bạn áp dụng trên các ứng dụng JS của mình. Kinda như ESLint imo.
  4. Bởi vì TS là một ngôn ngữ hoàn toàn mới, do đó nó có một đường cong học tập cao hơn .
  5. Việc chuyển đổi mã JS với Flow trở lại JS thuần túy sẽ dễ dàng hơn nhiều .
  6. Bạn có thể dễ dàng tích hợp Flow vào một ứng dụng JS hiện có .
  7. Flow, đơn giản, đơn giản hơn .

“Trong thực tế, nếu bạn viết một tệp dài 10.000 dòng mà không có phụ thuộc bên ngoài thì không có bất kỳ loại nào. Flow vẫn có thể chỉ cho bạn lỗi ở đâu. "
- James Kyle , thành viên của cả nhóm Babel và Flow

Trong ví dụ này, tôi sẽ sử dụng mẫu ứng dụng React được thảo luận trong bài viết trước của tôi . Tôi sẽ giải thích tất cả các cấu hình mà tôi đã thêm vào mẫu ứng dụng React đó.

Cài đặt Flow & thư viện hỗ trợ

Rõ ràng trước tiên chúng ta cần cài đặt Flow. Và bởi vì chúng tôi đang sử dụng Flow trong một ứng dụng React sử dụng Babel để biên dịch, chúng tôi cũng cần thêm một vài thư viện khác.

// install Flow
npm install --save-dev flow-bin
// install Babel support for Flow
npm install --save-dev @babel/preset-flow babel-plugin-transform-flow-strip-types

{
  "presets": [
    ...,
    "@babel/preset-flow"
  ],
  "plugins": [
    ...,
    "transform-flow-strip-types"
  ]
}

Trước khi có thể khởi động máy chủ Flow, chúng ta cần khởi tạo và cấu hình nó. Chạy lệnh này trước:

npm run flow init

[ignore]
.*/node-modules/.*
[include]
./src
[libs]
[lints]
[options]
react.runtime=automatic
[strict]

Để thực sự chạy máy chủ Flow, trước tiên tôi thêm tập lệnh này vào package.json:

"scripts": {
  ...,
  "flow": "flow",
  "flow-stop": "flow stop"
},

Sử dụng npm run flow-stoptrong trường hợp bạn muốn dừng quá trình chạy nền của máy chủ Flow.

Thêm hỗ trợ Luồng vào IDE

Tôi đang sử dụng Mã Visual Studio của Microsoft làm IDE của mình nên ví dụ bên dưới chỉ dành cho VSCode đó.

  1. Cài đặt plugin Dòng Hỗ trợ Ngôn ngữ bởi flowtype .
  2. Tắt hỗ trợ TypeScript có sẵn của VSCode.

Kiểm tra ở đây để biết thêm thông tin.

VSCode hiển thị lỗi kiểu tĩnh

Thêm trình kiểm tra kiểu tĩnh của Flow

Để thêm hỗ trợ kiểu tĩnh, chỉ cần thêm mã này vào dòng đầu tiên của bất kỳ tệp JS nào:

// @flow

Bằng cách thêm dòng này, bạn có thể áp dụng Flow tăng dần và dễ dàng xóa nó bất cứ lúc nào. Bạn có thể thử Flow out trên bất kỳ codebase nào và xem bạn thích nó như thế nào.

Kiểm tra tệp 002-react-flow/src/someMethods.jstrên ví dụ để xem tệp JavaScript được gõ tĩnh đơn giản.

Sử dụng các thành phần Flow trên React

Tôi sẽ không thảo luận về loại chú thích trong Flow , vì đã có rất nhiều tài liệu và bài báo về điều đó. Bên cạnh đó, các chú thích của Flow về cơ bản khá giống với một số chú thích được sử dụng trong TS hoặc bất kỳ ngôn ngữ lập trình được định kiểu tĩnh nào. Thay vào đó, tôi sẽ thảo luận về các chú thích được sử dụng cụ thể trên các thành phần React.

Thành phần React

Chúng ta cần nhập loại React mà chúng ta sử dụng vào thành phần. Bởi vì thông thường một thành phần React trả về a Node, chúng tôi cần đảm bảo rằng nó đã được nhập.

import type {Node} from "react";

type Props = {
  foo: number,
  bar?: string
};

type State = {
  count: number,
};

class SimpleComponent extends Component<Props, State> {
...

render(): Node {
...

// @flow
import type {Node} from "react";
import React, {Component} from 'react';
type Props = {
  foo: number,
  bar?: string,
};
type State = {
  count: number,
};
class SimpleComponent extends Component<Props, State> {
  constructor() {
    super();
this.state = {
      count: 0,
    }
  }
componentDidMount() {
    setInterval(() => {
      this.setState(prevState => (
        { count: prevState.count + 1 }
      ));
    }, 1000);
  }
render(): Node {
    return (
      <div>
        {this.props.foo} {this.props.bar}
        <br/>
        Count: {this.state.count}
      </div>
    );
  }
}
export default SimpleComponent;

Về cơ bản tương tự với ví dụ trước, với cú pháp hơi khác. Lưu ý rằng ở đây chúng tôi không mở rộng Componentđối tượng. Và chúng ta khai báo các loại thuộc tính trong tham số của hàm.

// @flow
import type {Node} from "react";
import React from 'react';
type Props = {
 text: string,
 addExclamMark: boolean,
};
const SimpleFuncComponent = ({text, addExclamMark}: Props): Node => {
 return (
  <div>
    {`${text}${addExclamMark ? '!' : ''}`}
  </div>
 )
};
export default SimpleFuncComponent;

Vâng, TS có một cộng đồng lớn hơn nhiều. Nhưng không có gì lạ khi chọn một công nghệ phù hợp hơn với phong cách / môi trường phát triển của bạn. Trong trường hợp của tôi, tôi thấy Flow là lựa chọn tốt nhất (trong việc phát triển các ứng dụng React). Một lần nữa, đây là một ý kiến ​​chủ quan. Tôi có thể thay đổi quyết định của mình trong tương lai, ai biết được. Nhưng tại thời điểm này, tôi cảm thấy thoải mái hơn nhiều khi sử dụng Flow. Và tôi biết một số tổ chức cảm thấy thoải mái khi không sử dụng tính năng nhập tĩnh trong ứng dụng JS của họ.

Cuối cùng, tôi đã cung cấp ứng dụng React mẫu hoàn chỉnh trên Github của mình. Nếu bạn gặp bất kỳ sự cố nào khi theo dõi bài viết hoặc chạy ứng dụng ví dụ hoặc có một số câu hỏi cần hỏi, vui lòng đề cập với tôi trên Twitter . Chúc mừng!

Suggested posts

Tránh những hậu quả tàn khốc của đột quỵ: Học hỏi từ hành trình của một gia đình.

Tránh những hậu quả tàn khốc của đột quỵ: Học hỏi từ hành trình của một gia đình.

Giới thiệu Đột quỵ là một trường hợp cấp cứu y tế có thể tấn công bất kỳ ai vào bất kỳ lúc nào. Nó xảy ra khi lưu lượng máu đến một phần của não bị gián đoạn, dẫn đến mất chức năng não đột ngột.

Tài nguyên mã hóa được sử dụng nhiều nhất của tôi

Tài nguyên mã hóa được sử dụng nhiều nhất của tôi

Tuần này, tôi nhận được một email từ một thành viên trong danh sách email hàng ngày. Họ muốn biết: Bạn truy cập tài nguyên nào hàng ngày, hàng tuần và hàng tháng? Câu hỏi tuyệt vời! Tôi rất vui khi cố gắng chia sẻ một số thông tin chi tiết về quy trình làm việc của mình và các tài nguyên hàng đầu mà tôi sử dụng.

Related posts

Cuộc đàn áp các Kitô hữu: Tội ác thù hận mà chúng ta không nói đến

Quên bài Hồi giáo đi: Cơ đốc nhân (và người Do Thái) là nạn nhân chính của tội ác căm thù tôn giáo.

Cuộc đàn áp các Kitô hữu: Tội ác thù hận mà chúng ta không nói đến

Bất kỳ lý trí nào cũng biết rằng giới chính trị và truyền thông bị chi phối bởi cánh tả, thậm chí là cực tả, một tình trạng tạo ra sự mất cân bằng trong diễn ngôn chính trị. Trong lĩnh vực tôn giáo, sự mất cân bằng này có thể thấy rõ ràng: các tờ báo và mạng lưới cánh tả không vội vàng bảo vệ đức tin Cơ đốc.

Tìm kiếm thông tin về tên miền

Đoạn trích từ Small, Sharp Software Tools của Brian P. Hogan

Tìm kiếm thông tin về tên miền

Khi bạn gửi yêu cầu tới facebook.com, máy tính của bạn sẽ tra cứu tên miền để dịch tên miền đó thành địa chỉ IP để máy tính của bạn có thể thực hiện kết nối đó.

Theo Dõi Bất Cứ Ai Chỉ Bằng Số Điện Thoại | Điều tra OSINT

Theo Dõi Bất Cứ Ai Chỉ Bằng Số Điện Thoại | Điều tra OSINT

Bạn có thể là Điều tra viên OSINT, Người chơi CTF hoặc đơn giản là người nhận được các cuộc gọi spam. Ai đó đang cố xác minh số bạn đã thấy trong quảng cáo.

Cách cứu hành tinh và kiếm tiền

Cách cứu hành tinh và kiếm tiền

Đã bao nhiêu lần bạn vứt bỏ chai nhựa, lọ thủy tinh, lon nhôm hay gói năng lượng xanh mà không cần suy nghĩ kỹ? Đã bao nhiêu lần bạn ước mình có thể nhận được thứ gì đó để đổi lại việc tái chế chúng? Nếu bạn giống như hầu hết mọi người, câu trả lời có lẽ là nhiều lần. Tái chế thường được coi là một rắc rối, một công việc vặt hoặc một nhiệm vụ không mang lại bất kỳ lợi ích tức thời hoặc hữu hình nào.