Home Web Front-end JS Tutorial Some tips to help make the code cleaner.

Some tips to help make the code cleaner.

Jan 01, 2025 am 03:18 AM

Some tips to help make the code cleaner.

I'll incorporate the principles from "The Clean Coder: A Code of Conduct for Professional Programmers" by Robert C. Martin (Uncle Bob). This book emphasizes professionalism, discipline, and practices that align with writing clean, maintainable code, and being an effective software engineer. Below is the revised, comprehensive guide tailored for mastering front-end development in 2025, incorporating The Clean Coder's teachings:


1. Professionalism: Coding with Discipline

The essence of The Clean Coder revolves around professionalism, which applies directly to how you code as a front-end developer.

1.1. Take Responsibility for Your Code

  • Own the Code: Accept responsibility for bugs, errors, and missed requirements. If something goes wrong, fix it promptly and learn from it.
  • Ask for Clarity: If requirements or designs aren’t clear, don’t proceed with assumptions. Instead, collaborate with stakeholders to ensure alignment.

1.2. Write Code You’re Proud Of

Adopt a craftsman mindset. The code you deliver should reflect your best effort, balancing performance, readability, and maintainability.


2. Code Readability: Craft Code Like Writing

Uncle Bob emphasizes the principle: "Your code is your craft." Code should be written so that others (and your future self) can easily read and understand it.

2.1. Simplicity over Cleverness

Avoid writing overly clever or cryptic code. Simple, clear, and boring code is often better than “smart” code that confuses your teammates.

Instead of:

const d = (x) => x % 2 ? 'odd' : 'even'; // Confusing intent
Copy after login
Copy after login

Do this:

const getOddOrEven = (number) => number % 2 === 0 ? 'even' : 'odd';
Copy after login
Copy after login

2.2. Naming Matters

  • Variable and function names should clearly describe their purpose.
  • Use verbs for functions (fetchMovies, calculateTotal) and nouns for variables (userList, movieDetails).

2.3. Keep Methods and Functions Small

Functions should do one thing and one thing well. Uncle Bob recommends limiting functions to 5-10 lines of code when possible.

Bad:

function renderMovieCard(movie) {
  // fetch data, format, render JSX in one place
}
Copy after login
Copy after login

Good:

Break this into multiple functions, such as fetchMovieDetails, formatMovieData, and renderMovieCard.


3. Separation of Concerns (Single Responsibility Principle)

Every piece of code should have a single, clear purpose.

3.1. Components, Logic, and Styles

  • Components: Handle only rendering/UI.
  • Logic: Encapsulate reusable logic in custom hooks or utilities.
  • Styles: Abstract styles into CSS Modules, utility-first CSS (e.g., Tailwind), or styled-components.

3.2. Example: A Cleanly Separated Component

Bad (Tightly coupled logic, styles, and rendering):

const d = (x) => x % 2 ? 'odd' : 'even'; // Confusing intent
Copy after login
Copy after login

4. Communication: Write Self-Documenting Code

Inspired by The Clean Coder, aim for code that requires minimal external documentation.

4.1. Code Should Tell a Story

Each line of code should flow logically, like reading a book. For example:

  • Abstract conditions into clearly named variables.
  • Replace “magic numbers” with named constants.

Before (Hard to understand):

const getOddOrEven = (number) => number % 2 === 0 ? 'even' : 'odd';
Copy after login
Copy after login

After (Readable intent):

function renderMovieCard(movie) {
  // fetch data, format, render JSX in one place
}
Copy after login
Copy after login

5. Testing: Your Safety Net

Testing is a major focus in The Clean Coder, emphasizing that professionals always test their work.

5.1. Test Coverage

Strive for at least:

  • 80% unit test coverage.
  • Testing key user journeys with integration tests or E2E tests.

5.2. Write Meaningful Tests

Good tests describe behavior and requirements—not implementation details.

Example Test:

function MovieCard({ movie }) {
  const isBlockbuster = movie.revenue > 1000000;
  return (
    <div>



<p>Good (Separation of concerns):<br>
</p>

<pre class="brush:php;toolbar:false">// hooks/useIsBlockbuster.js
export const useIsBlockbuster = (revenue) => revenue > 1000000;

// components/MovieCard.js
import { useIsBlockbuster } from '../hooks/useIsBlockbuster';
import styles from './MovieCard.module.css';

function MovieCard({ movie }) {
  const isBlockbuster = useIsBlockbuster(movie.revenue);
  return <div className={isBlockbuster ? styles.blockbuster : styles.movie}>{movie.title}</div>;
}
Copy after login

5.3. Test Automation

  • Automate tests using CI/CD pipelines (e.g., GitHub Actions, CircleCI).
  • Run performance tests to identify bottlenecks early.

6. Continuous Improvement

Uncle Bob stresses the importance of practicing your craft. This applies to front-end developers:

6.1. Refactor Relentlessly

  • Regularly revisit and improve code, especially areas with tech debt.
  • Apply Boy Scout Rule: “Leave the codebase cleaner than you found it.”

6.2. Learn New Tools and Techniques

  • Stay updated with modern front-end trends like React Server Components, Edge Rendering, and AI-assisted UX.

7. Time Management and Focus

Professionalism means delivering on time without cutting corners. Follow The Clean Coder’s advice for managing your time effectively.

7.1. Work in Iterations

Break down features into smaller, incremental deliverables.

7.2. Avoid Overcommitment

Learn to say “no” to unreasonable deadlines. Instead, negotiate deliverables that maintain quality.


8. Soft Skills: Collaboration and Communication

Professional programmers are team players. This applies to how you work with designers, product managers, and backend developers.

8.1. Communicate Early and Often

  • Share progress regularly.
  • Raise blockers or challenges as soon as possible.

8.2. Code Reviews

Engage actively in peer code reviews. Use them as opportunities for learning and improvement.


9. Clean Architecture in Frontend

Apply The Clean Coder's architectural principles to ensure your codebase remains maintainable as it grows.

9.1. Separate UI from State Management

  • Use Redux Toolkit or Zustand for centralized state.
  • Keep local state (like modal toggles) in components, but delegate complex state logic to dedicated libraries.

9.2. Use Dependency Injection

Pass dependencies (e.g., APIs or services) as props instead of hardcoding them. This improves testability.


10. Never Stop Learning

The essence of The Clean Coder is that professionalism is a journey, not a destination.

  • Books to Continue Mastery:
    • "Clean Architecture" by Robert C. Martin.
    • "JavaScript: The Good Parts" by Douglas Crockford.
    • "Refactoring" by Martin Fowler.
  • Hands-On Practice: Regularly build small side projects or contribute to open-source.

Final Thoughts

To become a master front-end developer in 2025, it’s crucial to embrace professionalism, clean code principles, and a mindset of continuous improvement. Apply these techniques daily, and over time, your code will reflect both technical excellence and craftsmanship. Let me know if you'd like a real-world project breakdown applying these concepts!

The above is the detailed content of Some tips to help make the code cleaner.. For more information, please follow other related articles on the PHP Chinese website!

Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Tools

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use

Zend Studio 13.0.1

Zend Studio 13.0.1

Powerful PHP integrated development environment

Dreamweaver CS6

Dreamweaver CS6

Visual web development tools

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

What should I do if I encounter garbled code printing for front-end thermal paper receipts? What should I do if I encounter garbled code printing for front-end thermal paper receipts? Apr 04, 2025 pm 02:42 PM

Frequently Asked Questions and Solutions for Front-end Thermal Paper Ticket Printing In Front-end Development, Ticket Printing is a common requirement. However, many developers are implementing...

Demystifying JavaScript: What It Does and Why It Matters Demystifying JavaScript: What It Does and Why It Matters Apr 09, 2025 am 12:07 AM

JavaScript is the cornerstone of modern web development, and its main functions include event-driven programming, dynamic content generation and asynchronous programming. 1) Event-driven programming allows web pages to change dynamically according to user operations. 2) Dynamic content generation allows page content to be adjusted according to conditions. 3) Asynchronous programming ensures that the user interface is not blocked. JavaScript is widely used in web interaction, single-page application and server-side development, greatly improving the flexibility of user experience and cross-platform development.

Who gets paid more Python or JavaScript? Who gets paid more Python or JavaScript? Apr 04, 2025 am 12:09 AM

There is no absolute salary for Python and JavaScript developers, depending on skills and industry needs. 1. Python may be paid more in data science and machine learning. 2. JavaScript has great demand in front-end and full-stack development, and its salary is also considerable. 3. Influencing factors include experience, geographical location, company size and specific skills.

How to achieve parallax scrolling and element animation effects, like Shiseido's official website?
or:
How can we achieve the animation effect accompanied by page scrolling like Shiseido's official website? How to achieve parallax scrolling and element animation effects, like Shiseido's official website? or: How can we achieve the animation effect accompanied by page scrolling like Shiseido's official website? Apr 04, 2025 pm 05:36 PM

Discussion on the realization of parallax scrolling and element animation effects in this article will explore how to achieve similar to Shiseido official website (https://www.shiseido.co.jp/sb/wonderland/)...

The Evolution of JavaScript: Current Trends and Future Prospects The Evolution of JavaScript: Current Trends and Future Prospects Apr 10, 2025 am 09:33 AM

The latest trends in JavaScript include the rise of TypeScript, the popularity of modern frameworks and libraries, and the application of WebAssembly. Future prospects cover more powerful type systems, the development of server-side JavaScript, the expansion of artificial intelligence and machine learning, and the potential of IoT and edge computing.

Is JavaScript hard to learn? Is JavaScript hard to learn? Apr 03, 2025 am 12:20 AM

Learning JavaScript is not difficult, but it is challenging. 1) Understand basic concepts such as variables, data types, functions, etc. 2) Master asynchronous programming and implement it through event loops. 3) Use DOM operations and Promise to handle asynchronous requests. 4) Avoid common mistakes and use debugging techniques. 5) Optimize performance and follow best practices.

How to merge array elements with the same ID into one object using JavaScript? How to merge array elements with the same ID into one object using JavaScript? Apr 04, 2025 pm 05:09 PM

How to merge array elements with the same ID into one object in JavaScript? When processing data, we often encounter the need to have the same ID...

How to implement panel drag and drop adjustment function similar to VSCode in front-end development? How to implement panel drag and drop adjustment function similar to VSCode in front-end development? Apr 04, 2025 pm 02:06 PM

Explore the implementation of panel drag and drop adjustment function similar to VSCode in the front-end. In front-end development, how to implement VSCode similar to VSCode...

See all articles